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Notice 

Appie Computer, Inc. reserves the right to make improvements in the 
product described in this manual at any time and without notice. 



Disclaimer of All Warranties and Liabilittes 

Appte CompuleJ", Inc. makes no warranties, either express or implied, with 
respect tp this manuial Or with respect to the software described in this 
manual, Its quality, performance, merchantability, or fitness for any 
particular purpose, Apple Computer, Inc. software is sotd or Jicensed "as 
is." The entire risk as to its quality and performance is with the buyer 
Should the programs prove defective lollowing their purchase, the buyer 
(and not Apple Computer, Inc., its distributor, or its retailer) assumes the 
entire cost of all necessary servicing, repair, or correction and any 
lncid€hntal or consequential damages- In no event will Apple Computer, Inc. 
be liable for direct, lindlrect, incidental, or consequentiaj damages resulting 
from any defect in She software, even if Apple Computer. Inc. has been 
advised of the possiblity of such damages, Some states do not allow the 
exclusion or timitation ot implied warranties or liability for incidental or 
consequentiai damages, so the above limitation or exclusion may not apply 
to you. 

This manual is copyrighted All rights are reserved This document may 
not, in whole or part, be copied, photocopied, reproduced, translated or 
reduced to any electronic medium or machine readable form without prior 
consent, in writing, from Apple Computer, Inc. 

© 1982 by Apple Computer, Inc. 
20525 Mariari Avenue 
Cupertino, California 95014 
(408) 996-1010 

The word Appte and the Apple logo are registered trademarks of 
Apple Computer. Inc 

Simultaneously published in the U.S. A and Canada. 



Warning 

This equipment has been certified to comply with the limits for a 

Class B computing device, pursuant lo Subpart J of Part 15 of FCC 
RuJes, Only peripherals (computer input.'output devices, terminals, 
printers, etc.) certified to comply with the Glass B limits may be 
attached to this computer. Operation with non-certified peripherals is 
likely to result in interference to radio and TV reception 
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Radio and Television Interference 

The equipment described in this manual generates and uses radio- 
frequency energy. If H is not installed and used properly, that is, in 
strict accordance with our instructions, it may cause interference 
with radio and television reception. 

This equipment has been tested and complies with the limits for a 
Class B computing device in accordance with the specifications in 
Subpart J, Part 15, of FCC rules. These rules are designed to 
provide reasonable protection against such interference in a 
residential installation. However, there is no guarantee that the 
interference will not occur in a particular installation, especially if 
you use a "rabbit ear" television antenna. {A "rabbit ear" antenna is 
the teiescoping-rod type usually contained on TV receivers.) 

You can determine whetJier your computer is causing interference 
by turning W off. If the interference stops, it was probably caused 
by the computer or its peripheral devices. To further isolate the 
problem: 

• Disconnect the peripheraJ devices and their input/output cables 
one al a time. If the interference stops, it is caused by either 
the penpheral device or its I/O cable. These devices usualiy 
require shielded 10 cables. For Apple peripheral devices, you 
can obtain the proper shielded cable from your dealer. For non- 
Apple peripheral devices, contact the manufacturer or dealer 
for assistance. 

If your computer does cause Interference to radio or television 
reception, you can try to correct the interference by using one or 
more of the following measures: 

■ Turn the TV or radio antenna until the interference stops. 

■ Move the computer to one side or the other of the TV or radio. 

• Move the computer farther away from the TV or radio. 

• Plug the computer into an outlet that is on a different circuit 
than the TV or radio. (That is, make certain the computer and 
the radio or television set are on circuits controlled by different 
circuit breakers or fuses.) 

• Consider installing a rooftop television antenna with coaxial 
cable lead in between the antenna and TV. 
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It necessary, you should consult your dealer or an experienced 
radio/television technician for additionaJ suggestions. You may find 
helpful the following booklet, prepared by the Federal 
Communications Commission: 

"How to identify ^nd Resoive Radio-TV interference Problems" 

This bookJet is available from the US Government Printing Office, 
Washington. DC 20402. stock number 004-00000345-4. 
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Foreword 




This Fs the reference manual for the Apple lie personal computer, 
/t contains detailed descriptJons of all of the hardware and 
firmware that make up the Apple lie and provrdes the technical 
information that peripheral-card designers and programmers 
need. There is an Addendum, bound separately, that contains 
source listings of the built-in firmware. 

This manual contains a lot of information about the way the 
Apple He works, but it doesn't tell you how to use the Apple lie. 
For this, you should read the other Apple lie manuals, especially 
the following: 

• The Apple lie Owner's Manual 

• The Applesoft Tutorial 

This manual is designed to answer the question, What's inside 
the box? ft describes the internal operation of the Apple lie as 
completely as possfble in a single volume. The criterion for 
deciding to include an item of information was whether it would 
help an assembly-language programmer or peripheral designer. 

Contents of This Manual 

The material in this manual is presented roughly in order of 
increasing intimacy with the hardware; the farther you go in the 
manuai, the more technical the matenal becomes. The main 
subject areas are 

• Introduction: Foreword and Chapter 1 

• Use of built-in features: Chapters 2 and 3 

• How the memory is organized: Ctiapter 4 

• Information for programmers: Chapters 5 and 6 



xllt 



■ Hardware implementation: Chapter 7 

• Additional informatiort: Appendices and Addendum 

Chapter 1 identifies the main parts of the Apple Me and tells 
where in the manual each part is described. 

The next two chapters describe the built in input and output 
features of the Apple lie. This part of the manual includes 
information you need for low-level programming on the Apple lie. 
Chapter 2 describes the built-in I/O features and Chapter 3 tells 
you how to use the firmware that supports them. 

Chapter 4 describes the way the Apple lies memory space Is 
organised, including the allocation of programmable memory tor 
the video dispiay buffers. 

Chapter 5 is a user manual for the Monitor that is included in thie 
built-in firmware. The Monitor is a system program that you can 
use for program debugging at the machine level. 

Chapter 6 describes the programmable features of the peripheral- 
card connectors and gives guidelines for their use 

Chapter 7 is a detailed description of the hardware that 
implements the features described in the earlier chapters. This 
information is included primarily for programmers and peripheral- 
card designers, but it will also help you if you just want to 
understand more about the way the Apple lie works. 

Addilionai reference information appears in the appendices. 
Appendix A is the manufacturer's description of the 6502 
instruction set. 

Appendix B contains additional copies of some of the tables that 
appear in the body of the manual. The ones you will need to 
refer to often are duplicated here tor easy reference. 

Appendix C is a directory of the built-in 1^ subroutines, including 
their functions and starting addresses. 

Appendix D lists the differences between the Apple lie and the 
earlier Apple II and Appie II Plus models and tells you which 
sections to look at for more information. 
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Following Appendix D is a giossary defining many of the 
technicai terms used in this manual. Some terms that describe 
the use of the Apple Me are defined in the giossanes of the other 
manuals listed above. 

Following the appendices, there is a selected bibliography of 
sources o( additional information. 

The Addendum to this manual contains the source fisting of the 
Monitor firmware. You can refer lo it to find out more about the 
operation of the Monitor subroutines listed in Appendix C, 

Symbols Used in This Manual 

Special text in this manual is set off in several different ways, as 
shown in these examples 

Inf ormat ion that oppears on the display screen Is 
set off by this screen- ahoped out 1 ine. 



Warning 

Important warnings appear in boxes like this- 



Captior>s, definiltons, and oJher short 
items appear in marginal glosses like 
[his. 



Information that is useful but is incidental to the text appears in grey 
boxes like this. You may want to skip over sucli boxes and return to 
therr later, 
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Chapter 1 



Introduction 



This fifst chapter introduces you to the Apple He itself, It shows 
you what the inside looks like, identifies the major components 
that make up the machine, and tells you where to find 
information about each one. These major components are shown 
in the diagram in Figure 1.1. 



Figure 1-1 Exploded Diagram of the 
Apple lie 
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Removing the Cover 

Remove the cover of the Apple flie by pulling up on the back 
edge until the fasteners on either side pop loose, then move the 
cover an inch or so towards the rear ot the machine to free the 
front oi the cover, as Shown in Figure 1-2. What you will see is 
shown in Figure 1-3. 
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Figure 1-2 RemQvli>g the Cover 



Figure 1'3 The Apple ile with the 
Cover Off 




Warning 

There is a red LED Oight-emitting diode) inside the Apple lie, in the 
left rear corner of the Circuit board H the LED is on* Jt means that 
the power Is on and you must turn it off before you Insert or 
remove anything. To avoid damaging the Apple Ile, don't even 
THINK of changing anything inside it witfioul first turning off the 
power. 
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Introduction 



The Keyboard 

The keyboard is the Apple Me s primary Input device. As shown in 
Figure 1-4, it has a normal typewriter layout, upper- and 
lowercase, with al8 of the special characters in the ASCII 
character set. (ASCII stands for American Standard Code for 
Information interchange.) The keyboard es fully integrated into the 
machine; its operation is described in the first part of Chapter 2. 
Firmware subroutines for reading the keyboard are described in 
Chapter 3. 



Rgure 1-4 Apple He Keyboard 
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The Speaker 

The Apple lie has a small loudspeaker in the bottom of the case, 
as shown in Figure 1-1. The speaker enables AppJe lie programs 
to produce a variety of sourids that make the programs more 
useful and interesting. The way programs control the speaker is 
described in Chapter 2. 

The Power Supply 

The power supply is inside the flat metal box along the left side 
of the interior of the Apple Me. It provides power for the main 
board and for any peripheral cards installed in the Apple Me. 

The power supply produces four different voltages: +5V, -5V, 
+ 12V, and -12V. It is a high-efficiency switching supply, and 
includes special circuits that protect it and the rest of the 
Apple Me against short circuits and other mishaps. Complete 
specifications of the Apple lie power supply appear In Chapter 7. 



The Keyboard 



Rgure 1"S Circuit Board 




The power switch and the socket for the power cord are mounted 
directly on the back of the power supply's metal case. This 
mounting ensures that all the circuits that carry dangerous 
voltages are inside the power supply. Do not defeat this design 
feature by attempting to open the power supply. 

The Circuit Board 

All of the electronic parts of the Apple He are attached to the 
circuit board, which is mounted flat in the bottom of the case. 

Figure 1-5 shows the main integrated circuits (iCs) in the 
Apple lie. They are the central processing unit (CPU), the 
keyboard encoder and read-only memory (ROM), the two 
interpreter ROMs, and the custom integrated circuits: the Input 
Output Unit (lOU) and the Memory Management Unit (MMU). 

The CPU is a 6502B microprocessor. The 6502B is a high-speed 
version of the 6502, which is an eight-bit microprocessor with a 
sixleen-bit address bus. It uses instruction pipeiining for faster 
processing than comparable microprocessors. In the Apple lie, 
the 6502B runs at 1 MHz and performs up to 500,000 eight-bit 
operations per second. The specifications of the 6502B are given 
in Chapter 7; the 6502 instruction set is given in Appendix A, 

The keyt>oard is decoded by an AY-36O0-type integrated circuit 
and a read-only memory (ROM). These devices are described in 
Chapter 7, 

The interpreter POMs are integrated circuits that contain the 
Applesoft BASIC interpreter. The ROMs are described in 
Chapter 7. The Applesoft language is described in the Applesoft 
Tutoriat and the Applesoft Reference Manual 

Two of the iarge ICs are custom-made for the Apple lie: the 
MMU and the lOU. The MMU IC contains most of the logic that 
controls memory addressing in the Apple Me. The organization of 
the memory rs described in Chapter 4; the circuitry in the MMU 
itself is described in Chapter 7. 

The lOU IC contains most of the logic that controls the built-in 
input/output features of the Apple lie- These features are 
described in Chapter 2 and Chapter 3; the lOU circuits are 
described in Chapter 7. 
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Connectors on The Circuit Board 

The seven siots lined up along the back of the Apple Ite circuit 
board are the expansion slots, sometimes called peripheral slots 
(see Figure 1-6). These slots make it possible to attach additional 
hardware to the Apple lie. Chapter 6 tells you how your programs 
deal with the devices that plug into these slots; Chapter 7 
describes the circuitry for the slots themselves. 



Figure 1-6 Expansion Slots 
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The large slot next to the left-hand side of the circuit board is the 
auxiliary slot (Figure 1-7). If your Apple lie has an Apple (le 60- 
column text card, it will be installed in !:his slot. The 80-column 
display option Is tully integrated into the Apple lie; it is described 
along with the other display features in Chapter 2- The hardware 
and firmware Interfaces to this card are described in Chapter 7. 



Connectors on The Circuit Board 




Figure 1-B Back Panol Cooneetors 




There are also smaller connectors for game I/O and for an 
internal RF (radio frequency) modulator. These connectors are 
described in Chapter 7. 

ConrtBctors on the Back Panel 

The back of the Apple lie has two miniature phone jacks for 
connecting a cassette recorder, an RCA-type jack for a video 
monitor, and a 9-pin D-type miniature connector for the hand 
controls, as shown in Figure 1-6. In addition to these, there are 
spaces for additional connectors used with the peripheral cards 
installed in the Apple lie. The installation manuals for the 
peripheral cards contain instructions for installing the 
peripheral connectors. 
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Chapter 2 



Built-in 110 Devices 



This chapter describes the input and output (I/O) devices built 
into the Apple He in terms of their functions and the way they are 
used by programs. The buiit-in I/O devices are 

• keyboard 

• video-display generator 

• speal<er 

• cassette input and output 
■ game Input and output 

At the lowest level, programs use the built-in I/O devices by 
reading and writing to dedicated memory locations. This chapter 
lists these locations for each I/O device. It also gives the 
locations of the internal soft-switches that select the different 
display modes of the Apple lle^ For descriptions of the buift-in 
I/O hardware, refer to Chapter 7. 

This melhod of input and output — loading and storing directfy to 
specific locations in memory — is not the only melhod you can use. 
For many of your programs, it may be more convenient to call the 
byilt-in I/O routines stored in the Appie lie's firmware. These 
firmware routines are describod in Chapter 3. 



The Keyboard 

The primary input device of the Apple Me is its built-in keyboard. 
The keyboard has 63 keys and is similar to the keyboard of a 
typewriter. The Apple lie keyboard has automatic repeat on all 
keys: hold the key down to repeat. It also has M-key rollover, 
which means that you can hold down any number of keys while 
typing another. OJ course, if you hold the keys down much longer 
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Figure Z-1 The Keyt)oard 



Table 3^1 Apple ile Keyboard 

Specifications 



than the length of time you would hold them down during normal 
typing, the aulomatic-repeat function will start repeating the last 
key you pressed. 

The keyboard arrangement shown in Figure 2-1 is the standard 
one used in the United States. The specifications for the 
keyboard are given in Table 2-1. Apple lie's manufactured for 
sale in Europe have a slightly different standard keyboard 
arrangement and indude provisions for switching between two 
different arrangements. 



' — ^-T 



ESC 


1 


2 3 


4 5 


- . & . 

6 7 8 


■ ( ) - 


+ 


□FLETC 


r^ti 
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T V U 
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. ■ ■ 


SHIFT y 


X C 


< > 
V B N M . 
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^hll■ ■ 


CAPS 
LOCK 


- 
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* - - 1 1 



In addition to the keys normally used for typing characters, there 
are four cursor-control keys with arrows: left, right, down, and up. 
The cursor-control keys can be read the same as other keys; 
their codes are $08, SI 5, $0A, and $0B (see Table 2''3a). 



Number of keys: 63 

Character ercoding; ASCI 

Number ot codes; 1 2B 
Special keys: 



CQNTRDLL rSH[FT|,| CftPS LOCK |Ji E5C |, 



I RESET ] . | LEFT-ftR WON|, ^IGHT-RRHOnJ , 

[up^ARRQw]p [DOWN^^RbEw], |Q"p"EH-ftPPLE] .. 



SDLID-flPPL£ 



Rollover'. 



N key 



Electrical inleriace: AY-5"3BOa keyboard encodar 
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Four special keysJ "a]NTROL \ , \ 5H[FT | , |CflP5 LOCK "|, and 



change the codes generated by (he other keys. The [ cdntrdL 




key is similar to the A SCJI CTR L key. Three other keys have 
speciai: functions: the I reset | key, and two keys marked with 
appl eSn one outlined, or open, and one solid, or closed. Pressing 
the I RESET ' key with the | cQmTrQl key depressed resets the 
Apple lie. as described In Chapter 4. The Apple keys are 



connected to the one-bit game inputs, described iater in (his 
chapter. 

The electrical interface between the Apple lie and the keyboard is 
a ribbon cable with a 26'pin connector This cable carries the 
keyboard signals to the encoding circuttry on the main board, A 
complete description of the electrical intertace to the keyboard is 
given in Chapter 7. 

Reading the Keyboard 

The keyboard encoder and ROM generate all 128 ASCII codes, 
so all of the special characler codes in the ASCII character set 
are available (rom the keyboard. Machine-language programs 
obtain characler codes from the keyboard by reading a byte from 
the keyboard-data location shown in Table 2-2. 



Table 2-2 Keyboard Memory 
Locations 


Location 

Hex 


Decimal 


Description 




tCODO 

tcDi a 


49152 -16364 
49188 -18368 


Keyboard data and strobe 

Any-key<lawn Tlag end Clear-strqbe swilcti 



HeKadeclmar refers to the tiase-ta 
number system, which uses the ler 
digits throjgh 9 and the eIk tietters A 
through F to represent values from 
to 15- 



Your programs can get the code for the last key pressed by 
reading the keyboard-data location. Table 2-2 gives this locatfon 
in three different forms: the hexadecimat value used in assembly 
language, indicated by a preceeding dollar sign {$); the decimai 
value used in Applesoft BASIC, and the complementary decimal 
value used in Apple Integer BASIC. {Integer BASIC requires that 
values greater than 32767 be written as the number obtained by 
subtracting 65536 from the value. These are the decimal 
numbers shown as negative In the tables: refer to the Apple if 
BASIC Programming ManuaL) The low-order seven bits of the 
byte at the keyboard location contain the character code, the 
high-order bit of this byte is the strobe bft, described below. 



The Keyboard 



13 



l: 



l; 



L 
L 



Table 2-3b Keys and ASCI I Codes, 
Goritinued 

Codes are shown here ir hexadecimal; 
to ftnd' the decimal equivalents, jse 
Table 2-4 



V 



location. This location is a combtnation flag and switch; the flag 
tells whether any key is down, and the switch clears the strobe 
bit. The switch function of this memory location is called a soft 
switch because it is controlled by software. In this case, it 
doesn't matter whether the program reads Of writes, and it 
doesn't matter what data the program writes' the only action that 
occurs is the resetting of the keyboard strobe- Similar soft 
switches, described later, are used tor controlling other functions 
in the Apple lie. 

Any time you read the Any-key-down ffag, you also dear the 
keyboard strobe. If your program needs to read both the Mg and 
the 3trobe, it must read the strobe bit first 



Key 


Normal 


ContraJ 


Shift 


Both 
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50 


ID 


7D 


ID 
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60 


60 


7E 


7E 




A 


61 


01 


41 


01 




B 


62 


02 


42 


02 




C 


63 


03 


43 


03 




D 


64 


04 


44 


04 




£ 


85 


05 


4S 


as 




F 


66 


06 


46 


06 




G 


67 


07 


47 


07 




H 


6B 


06 


4fl 


OG 




1 


€9 


00 


4S 


09 




J 


6A 


OA 


4A 


OA 




K 


6B 


OB 


4B 


OB 




L 


6C 


OC 


4C 


OC 




M 


6D 


OD 


4D 


OD 




N 


6E 


OE 


4E 


OE 







6F 


OF 


4F 


OF 




P 


70 


10 


SO 


SO 




Q 


71 


11 


SI 


11 




R 


72 


ia 


52 


12 




S 


73 


13 


53 


13 




T 


74 


14 


54 


14 




U 


75 


15 


55 


15 




V 


76 


16 


56 


16 




w 


77 


17 


57 


17 




X 


7S 


19 


56 


18 




Y 


79 


19 


59 


19 




z 


7A 


IA 


5A 


IA 
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After the keyboard strobe has been cleared, it remains low until 
another key is pressed. Even after you have cleared the strobe, 
you can still read the character code at the keyboard location. 
The data byte has a different value, because the high-order bit is 
no longer set, but the ASCII code in the seven low-order bits is 
the same until another key is pressed, Tables 2-3a and 2-3b 
show the ASCII codes for most of the keys on the keyboard of 
the Apple Ife. 



Table 2-4 The ASCII Character Set 



Dec 


Hex 


Char 


Ok 


HOK 


Char 


Oec 


Hex 


Char 


Dec 


Hex 


Ctiar 





OO 


NUL 


32 


20 


SP 


64 


4D 


@ 


96 


60 


^ 


1 


01 


SQH 


33 


21 


1 


65 


41 


A 


97 


61 


a 


2 


02 


STX 


34 


22 


II 


66 


42 


G 


98 


62 


b 


3 


03 


ETX 


35 


23 


# 


67 


43 


C 


99 


63 


c 


4 


04 


EOT 


36 


24 


s 


63 


44 


D 


100 


64 


d 


5 


05 


EWO 


37 


25 


% 


69 


45 


E 


101 


65 


e 


6 


06 


ACK 


3S 


26 


& 


70 


46 


F 


102 


66 


f 


7 


07 


BEL 


39 


27 


f 


71 


47 


G 


103 


67 


9 


B 


08 


es 


40 


2a 


( 


72 


48 


H 


104 


63 


h 


9 


09 


HT 


41 


29 


) 


73 


49 


1 


105 


69 


i 


10 


OA 


LF 


42 


2A 


■ 


74 


4A 


J 


loe 


6A 


J 


11 


OB 


VT 


43 


2S 


+ 


75 


4B 


K 


107 


6G 


k 


12 


OC 


FF 


44 


2C 


, 


76 


4C 


L 


108 


6C 


1 


13 


OD 


CB 


45 


20 


- 


77 


4D 


U 


109 


6D 


m 


14 


OE 


SO 


46 


2E 




78 


4E 


K 


110 


6E 


n 


15 


OF 


SI 


47 


2F 


y 


79 


4F 





111 


6F 





16 


10 


OLE 


4B 


30 





80 


50 


P 


112 


70 


P 


17 


11 


DC1 


49 


31 


1 


Bt 


51 





113 


71 


Q 


ie 


12 


DC2 


50 


32 


2 


82 


52 


R 


114 


72 


r 


19 


13 


DC3 


51 


33 


3 


83 


53 


S 


115 


73 


s 


2Q 


14 


DC4 


52 


34 


4 


84 


54 


T 


116 


74 


t 


21 


15 


NAK 


53 


35 


5 


85 


55 


U 


117 


75 


u 


22 


16 


SYM 


&4 


36 


6 


86 


56 


V 


113 


76 


V 


23 


17 


ET0. 


55 


37 


7 


87 


57 


w 


119 


77 


w 


24 


16 


CAN 


56 


33 


3 


86 


56 


X 


120 


73 


S( 


25 


19 


EM 


57 


39 


9 


S9 


59 


Y 


121 


79 


y 


26 


1A 


SUB 


59 


3A 




90 


5A 


Z 


122 


7A 


2 


27 


1B 


ESC 


59 


3a 


; 


91 


5B 


1 


123 


7B 


{ 


2B 


1C 


^d 


60 


3C 


<: 


92 


5C 


\ 


124 


7C 


1 


29 


ID 


GS 


61 


3D 


= 


93 


5D 


1 


125 


7D 


} 


30 


IE 


RS 


62 


3E 


> 


94 


5E 


A 


126 


7E 


- 


31 


IF 


US 


63 


3F 


7 


95 


5F 


— 


127 


7F 


DEL 
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There are several special-function keys that do not gene rate 
ASCI I codes. Fore icample,voucannotreadthercO MTRQL I JSHJFT 
and [CAPS LDciTI keys directly, but pressfng one of these keys 
afters the character codes produced by the other keys. 



Another key that doesn't generate a code is the [RESET] key, 
located at the upper-right corner of the keyboa rd; it is co nnected 
directly to the Apple lie's circuits. Pressing the [RESET] key with 
the LCDNTROj^J key depressed normaJly causes the system to stop 
whatever program its running and restart Itself. This restarting 
process Is called the reset routine, and it is described in 
Chapter 4. 

Two more special keys are marked with two versions of the 
Apple logo and located on either sJde of the space bar. The key 
with the outlined apple is th erpPEH-flPPLE "J key; the key with the 
solid-color apple is the [ SDLlD-fl PPLE 1 key. These keys are 
connected to the one-bit game inputs, which are described later 
in this chapte r. Pressing them In combination with the | control I 
'reset! 



keys causes the built-in firmware to perform special 
reset and self-test cycles, described with the reset routine in 
Chapter 4. 



The Video Display Generator 

The primary output device of the Apple Me is the video display 
You can use any ordinary video monitor, either color or black- 
and-white, to display video information from the Apple lie. An 
ordinary monitor is one that accepts composite video compatible 
with the standard set by the NTSC (National Television 
Standards Committee), If you use Apple lie color graphics with a 
black-and-white monitor, the display will appear as different 
shades of gray. 

If you are only using 40-column text and graphics modes, you 
can use a television set for your video display. If the TV set has 
an input connector for composite vrdeo. you can connect It 
directly to your Apple lie; if It does not. youll need to attach an 
RF video modulator between the Apple Me and the television set. 

With the 80-column text card insialied. the Apple lie can produce an 
eO-column text display However, if you use an ordinary coior or 
black-and-white television set, SO-column text will be too blurry to 
read. For a dear 80-column display, you must use a high-resolution 
video monitor with a bandwidth of 14 MHz or greater. 
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Table 2-B Video Display 
Specifications 



The specifications for the video display are summarized in 
Table 2-5. 



Display modes: 



Text capacity: 



Character set: 



Display formats: 



40-colLimn text 

80-cQlumn text with optional card 

Low- re solution Color graplTiBCS 
High-resolution color graphics 

24 lines by 40 columns 
24 lines by 80 columns with 
optioneE card 

96 ASCII characlefs 
(uppercasa and iowercase) 

Normal^ Invarsen Flaslilng 



Low-resciulcon graphics: 16 colors. 40 horizontal by 
48 vertical 

High-resolution graphics: 6 coiorg, 2S0 lioiizontal by 

19a vertical 



The video signal produced by the Apple lie is NTSC-compalible 
composite color video It is available at three places: the RCA- 
type phono jack on the back ot the Apple He, the single Molex- 
type pin on the main circuit board near ttie back on the right 
side, and one ol the group of four Molex-type pins in the same 
area on the main board. Use the RCA-type phono jack to 
connect a video monitor or an external video modulator; use the 
Molex pins to connect the type of video modulator that fits inside 
the Apple Me case. For a full description o1 the video signal and 
the connections to the Molex-type pins, refer to the section 
"Video Outpul Signals" in Chapter 7. 

The Apple lie can produce four different kinds of video display: 

• Text, 24 lines of 40 characters 

• Text, 24 lines of 80 characters {with optional' card) 

• Low-resolution graphics, 40 by 48, in 16 colors 

• High-resolution graphics, 280 by 192. in 6 colors 
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Either of the two text modes can disptay all 96 ASCII characters: 
me upper- and lowercase letters, numbers, and symbols. 

Either of the graphics displays can have four lines of text, either 
40-colunin or BO-column, at the bottom of the screen. Graphics 
displays with text at the bottom are called mixed-mode dispiays. 

The low-resoiutlon graphics display is an array of colored blocks, 
40 wide by 48 high, in any of sixteen colors. In mixed mode, the 
four lines of text replace the bottom eight rows of blocks, leaving 
40 rows of 40 blocks each. 

The high resolution graphics display is an array of dots, 280 wide 
by 192 high. There are six colors available in high-resolution 
displays, but a given dot can only use four of the six colors. In 
mixed mode, the four lines of text replace the bottom 32 rows of 
dots, leaving 160 rows of 280 dots each. 



Text Modes 

The text characters displayed include the upper- and lowercase 
letters, the ten digits^ punctuation marks, and special characters. 
Each character is displayed in an area of the screen that is 
seven dots wide by eight dots high. The characters are formed 
by a dot matrix five dots wide, leaving two blank columns of dots 
between characters in a row. Except for lowercase letters with 
descenders, the characters are only seven dots high, leaving one 
blank line of dots between rows of characters. 

The normal display has white (or other single color! dots on a 
black background. Characters can also be displayed as black 
dots on a white background; this is called inverse format. 

Text Charactsr Sets 

The Apple lie can display either of two text character sets: the 
primary set or an alternate set. The forms of the characters in 
the two sets are actually the same, but the available display 
formats are different. The display formats are 

• normai, with white dots on a black screen; 

• inverse, with black dots on a white screen; and 

• ffashing, alternating between normal and inverse. 
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Tabte2'6 The Drsplay Character Sels 

To identify particular characters and 
val jes, refer to Table 2-4. 



With the primary character set, the Apple lie can display 
uppercase characters in all three formats: normal, inverse, and 
flashing. Lowercase letters can only be displayed in normal 
format. The primary character set is compatible with most 
software written for the Apple II and Apple II Plus modets, which 
can display te>ct in flashing format but don't have lowercase 
characters. 

The alternate character set sacrifices the flashing format for a 
complete inverse format. With the alternate character set, the 
Apple He can display uppercase letters, lowercase letters, 
numbers, and special characters in either normal format or 
inverse format. 

You select the character set by means of the alternate text soft 
switch, described below in the section "Dispfay fvlode Switching". 
Table 2-6 shows the character codes in decimal and hexadecimal 
for the Apple lie primary and alternate character sets in normal 
inverse, and flashing formats. 





Primary Character Se^t: 


Alternate Ctiaracter Set: 


Hex Values 


Character Type 


Format 


Character Type 


Formal 


$00-$ 1 F 


Uppercase letters 


Inverse 


Uppercase ielters 


Inverse 


S20-S3F 


Special characters 


Inverse 


Special characters 


Inverse 


S40-$SF 


Uppercase letters 


Flashing 


Uppercase letters 


Inverse 


S60-$7F 


Special characters 


Flashing 


Lowercase letters 


Inverse 


$eo-$9F 


Upfiercaee tellers 


Normal 


Uppercase letters 


Normal 


SAO-SSF 


Special characters 


NQimal 


Special characters 


Normial 


SCO-$DF 


Uppercase letters 


Normai 


Uppercase letters 


Normal 


$EO-SFF 


Lowercase l^etiers 


Normal 


Lowercase letters 


Normal 



J 

J 
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Figure 2-2 40-c:c)]LjrTin Texi Display 



Each character on the screen is stored as one byte of display 
data. The low-order six bits make up the ASCII code of the 
character being displayed. The remaining two (high-order) bits 
select inverse or flashing format and uppercase or lowercase 
characters. In the primary character set, bit 7 selects inverse or 
normal format and bit 6 controls character flashing. In the 
alternate character set, bit 6 selects between upper- and 
lowercase, according to the ASCII character codes, and flashing 
format is not available, 

40-cofunin versus 80-coiumn T&xt 

The Apple lie has two modes of text display: 40-column and BO- 
column. (The SO-column display mode described in this manual is 
the one you get with the SO-cotomn text card or other auxiliary- 
memory card installed in the auxiliary slot.) The number of dots 
in each character does noi change^ but the characters in 80- 
column mode are only half as wide as the characters in 40- 
column mode Compare Figure 2-2 and Figure 2-3. On an 
ordinary color or black-and-white television set, the narrow 
characters in the 6Q-co(umn display biur together; you must use 
the 40-column mode to display text on a television set. 



10 REN APPLESOFT CHARACTER OEMO 

£0 TE^T ■- HOME 

70 PRINT ■■ PRIHT "Applesoft Char 

^cter D^mo" 
40 PRIKT :, PRINT "Which characte 

50 PRINT ■■ INPUT "Primary <P:^ or 

f^lternate < fi ) ?"jft* 
SO IF LEN (ft$> < 1 THEN 59 
65 LET ft* = LEFT* <A*.l > 
79 IF A$ = "P" THEN POKE 49166. 



S0 IF ft* = "ft" THEN POKE 4916?. 

8 
90 PRINT ■- PRINT V, printing th 
,^^ e saf!* Hne^ first" 
100 PRINT ° in NORrtfiL. then INUE 

RSE >then FLASH " PRINT 
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Figure 2-3 80-column Teirt Display 



le m mm 

29 \W ■■ HUE 

39 ^lifT ■ PftlMT "flwlesthft tharartar Hm' 

1^ ffl liT : HfllET -lihich chjTKter set-" 

PR tfT ■ llffr '?rtBjry (?) or ftltemaU di^ ^'i» 

IF L£H (W) (1 THBt S9 
«■ L£T«= LEFJ^flM5 
?! If ftj = -P* Wi PDKF 45I5S.B 
3^ If At = 'f Tie ?m 43l£7.ft 
IS I^IHT ■ mj ■, , .prmtiiig tfs saw lint, first* 

rther FliiSB ■ HtlJff 



JIlfT ^ f«H{r ^ mir 'Pths m N^ te repeat.* 



PfilKT^SmcTtKr- iuis. 



Graphics Modes 

The Apple Me can produce video graphics in either of two 
different modes. Both graphics modes treat the screen as a 
rectangular array of spots. Normally, your programs will use the 
features of some high-level language to draw graphics dots, 
lines, and shapes in these arrays; this section descnbes the way 
the resulting graphics data are stored in the Apple He's memory. 

Low-resolution Graphics 

In the low-resolution graphics mode, the Apple lie displays an 
array of 48 rows by 40 columns of colored bbcks. Each block 
can ba any one of sixteen cotors, including black and white. On 
a black-and-white monitor or television set, these colors appear 
as black, while, and three shades of gray, There are no blank 
dots between blocks; adjacent blocks of the same color merge to 
make a larger shape. 

Data for the low-resolution graphics display is stored in the same 
part of memory as the data for the 40-column text display. Each 
byte contains data for two low -resolution graphics blocks. The 
two blocks are displayed one atop the other in a display space 
the same size as a 40-column text character, seven dots wide by 
eight dots high. 

Half a byte — four bits, or one nybble — is assigned to each 
graphics block. Each nybble can have a value from to 15, and 
this value determines which one of sixteen colors appears on the 
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screen. The colors and their corresponding nybble values are 
shown in Table 2-7. In each byle, (he low-order nybble sets the 
color for the top block of the pair, and the high-order nybble sets 
the color for the bottom block. Thus, a byte containing the 
hexadecimal value $D8 produces a brown block atop a yellow 
block on the screen. 



Table 2-7 Lnw-re^olulion Graphics 
Colors 


Hybble 

Decimal 


Value 
Hex 


Color 


Nybble 
Decimal 


Vatue 
1 Hex 


Color 


Colors may vary, depending upon the 
Controls or the monilor or lelevision 
set. 




1 


S1 


Black 
Magsnta 


8 
9 


S9 


Brown 

Orange 




2 


S2 


Dark Blue 


10 


$A 


Grey 2 




3 


S3 


Purple 


t1 


SB 


Pink 




4 


S4 


Dark Green 


ta 


$C 


Light Green 




5 


S5 


Grey 1 


13 


$D 


Yellow 




6 


S6 


Medium Blue 


14 


$E 


Aquamarine 




7 


S7 


Lighl Blue 


15 


$F 


White 



As explained below in the section "Display Pages", the text 
display and the low-resolution graphics display use the same 
area In memory. Most programs that generate text and graphics 
clear this part of memory when they change display modes, but it 
is possible to store data as text and display it as graphics, or 
vice-versa. All you have to do is change the mode switch, 
described in the section "Display Mode Switching", without 
changing the display data. This usually produces meaningless 
jumbles on the display, but some programs have used this 
technique to good advantage tor producing complex low- 
resolution graphics displays quickly. 

High-resotution Graphics 

in the high-resolution graphics mode, the Apple Ife displays an 
array of colored dots in 192 rows and 280 columns The colors ^ 
available are biack, white, purple, green, orange, and blue. 
although the colors of the individual dots are limited, as 
described tielow. Adjacent dots of the same color merge to form 
a larger colored area. 
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Data for the high-resolution graphics displays are stored in eilher 
of two 8192-byte areas in memory. These areas are called htgh- 
resolution Page 1 and Page 2; think of them as buffers where 
you can put data to be displayed. Normally, your programs will 
use the features of some high-level language to draw graphics 
dots, lines, and shapes to display; this section describes the way 
the resulting graphics data are stored in the Apple lie's memory. 

The Apple lie high- resolution graphics dispiay is bit mapped: each 
dot on the screen corresponds to a bit in the Appie Me s memory. 
The seven low-order bits of each display byte control a row of 
seven adjacent dots on the screen, and forty adjacent bytes in 
memory control a row of 280 (7 times 40) dots. The least 
significant bit of each byte is dispiayed as the leftmost dot in 3 
row of seven, fallowed by the second-least significant bit. and so 
on, as shown in Figure 2-4. The eighth bit (the most significant) 
of each byte is not displayed; it selects one o1 two colof sets, as 
described below. 

On a black-and-white monitor, there is a simple correspondence 
between bits in memory and dots on the screen. A dot is white if 
the bit controlling it is on {1 ), and the dot is black If the bit Is off 
(0). On a black-and-white television set, pairs of dots blur 
together; alternating black and white dots merge to a continuous 
grey. 

On an NTSC color monitor or a color television set. a dot whose 
controlling bit is off (0) is black. If the bit is on, the dot will be 
white or a color, depending on its position, the dots on either 
side, and the setting of the high-order bit of the byte. Call the 
left-most column of dots column zero, and assume (for the 
moment) that the high-order bits of all the data bytes are oil (0). 
If the bits that control them are on, dots in even-numbered 
columns, 0, 2. 4, and so forth, are purple, and dots in odd- 
numbered columns are green — but only if the dots on either 
side are black. If two adjacent dots are both on, they are both 
white. 

You select the other two colors, blue and orange, by turning the 
high-order bit (bit 7) of a data byte on (1). The colored dots 
controlled by a byte with the high-order bit on are either blue or 
orange: the dots in even-numbered columns are blue, and the 
dots In odd-numbered columns are orange — again, only If the 
dots on either side are black Within each horizontal line of seven 
dots controlled by a single byte, you can have black, white, and 
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Tabl« 2-0 High-resalulion Graphics 

Colors 

Colors may vary, depending on the 

adj jslment of !tie monitor or television 
set. 



Figure 3*4 High-resolution Display Bits 
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one pair of colors. To change the color of any dot to one of the 
other pair of colors, you must change the high-order bit of its 
byte, which affects the cofors of aJI seven dots controlled by the 
byte. 

In other words, high-resolution graphics displayed on a color 
monitor or television set are made up of colored dots, according 
to the following rules: 

• Dots in even columns can be biack. purple, or blue. 

• Dots in odd columns can be black, green, or orange 

• If adjacent dots in a row are both on, they are both white. 

• The colors In each row of seven dots controlled by a single 
byte are either purple and green, or blue and orange, 
depending on whether the high-order bit is off (0) or on (1). 

These rules are summarised in Table 2-8, The blacks and whites 
are numbered to remind you that the high-order bit is different. 



Sit» 0-6 



Bit 7 Off 



Bit 7 On 



Adjacent columns off 
Ever columns on 
Odd columns on 
Adjacent columns on 



Black 1 

Pjrple 
Green 

While 1 



Black 2 
BJne 
Orange 
White 2 



The peculiar behavior of the high-resolution colors reflects the 
way NTSC color television works. The dots that make up the 
Apple lie video signal are spaced to coincide with the frequency 
of the color subcarrier used in the NTSC system. Alternating 
black and white dots at this spacing cause a color monitor or TV 
set to produce color, but two or more white dots together do not. 
For more details about the way the Apple He produces color on a 
TV set, see Chapter 7. For information about the way NTSC 
color television works, see the magazine articles listed in the 
bibliography. 
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Display Pages 

The Apple Me generates its video displays using data stored In 
specific areas in memory. These areas, called display pages, 
serve as buffers where your programs can put data to be 
displayed. Each byte in a display buffer controls an object at a 
certain location on the display. In text mode, the obiect is a 
single character; in low-resolution graphics, the object is two 
slacked colored blocks; and in high-resolution mode, it is a line 
of seven adjacent dots. 

The 40-column-text and low-resofution-graphics modes use two 
display pages of 1024 bytes each. These are called text Page 1 
and Text Page 2. and they are located at 102 A- 20^7 (hexadecimal 
*400-47FF) and 20*^9-30 71 {*aDO " *BFF)in main memory. Normally, 
only Page 1 is used, but you can put text or graphics data into 
Page 2 and swilqh displays instantly. Either page can be 
displayed as 40-;column text, low- resolution graphics, or mixed- 
mode (four rows of text at the bottom of a graphics dispiay), 

The 80-column text mode displays twice as much data as the 
40-coEijmn mode — 1920 bytes — but it cannot switch pages. The 
eo-cotumn text display uses a combination page made up of text 
Page 1 in main memory plus another page in auxiliary memory 
located on the 80-column text card. This additional memory is NOT 
the same as text Page 2 — in fact, it occupies the same address 
space as text Page 1, and there is a special soft switch that enables 
you to store data into it (see the section "Display Mode Switching", 
below). The built-in firmware I/O routines described in Chapter 3 
take care of this extra addressing automatically; that is one reason 
to use those routines for ali your normal text output 

The high-resolution graptilcs mode also has two display pages, 
but each page is 8192 bytes long. In the 40 column text and low- 
resolution graphics modes each byte controls a display area 
seven dots wide by eight dots high. In high-resolution graphics 
mode each byte controls an area seven dots wide by one dot 
high. Thus, a high resolution display requires eight times as 
much data storage, as shown in Table 2-9. 
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Table 2-9 Video Display Page 
Locations 



"Nole: SOH^alumn mode uses Ihe 
1024-byte page-i locations in both 

mam and auxiliary memory. The 
PAGE^swilch is used to select one 
or the othief (or sionng data {see tlie 
section "Display Mode Switching''^. 



Display mode 


Page 


LowebI 
Addrfii&s 


Higtiest 

Addfeas 


4&-column Tejfl, 
Low-resolution 
Grap tiros 


1 

2 


*400 


1024 

2048 


«7FF 
«BFF 


2047 
3071 


BO-oolumn Text 


r 


14 DQ 


tO?4 


»7FF 


3047 


Higti-resolution 
Graptiics 


1 

2 


«£Q00 


B192 

16384 


«3FFF 

SBFFF 


16383 

24575 





Display Mode Switching 

You select the display mode that is appropriate for your 
application by reading or writing to a reserved memory iocalloni 
called a soft switch. In the Apple lie, most soft switches have 
three memory locations reserved for them: one for turning the 
switch on, one for turning it off, and one for reading the current 
state of the switch, 

TabJe 2-10 shows the reserved locations for the soft switches 
that control the different display modes. For example, to switch 
fn?m mixed-mode to full-screen graphics in an assembly-language 
program, you could use the Instruction: 

STA tC05£ 

To do this in a BASIC program, you could use the instruction: 

POKE 49^34,0 

The table gives the switch locattons in three forms: hexadecimal, 
decimal, and negative decimaf. You can use the hexadecimal 
values in your machine-language programs. Use the decimal 
values in peek or poke commands in Applesoft BASIC: the 
negative values are for Integer BASfC. 

You may not need to deal with these functions by reading and 
writing directly to the memory locations in this table. Many of the 
functions shown here are selected automaiically if you use the 
display routines in the various high-level languages on the Apple lie. 
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Table 2-10 Display Soft Switches 

(l)This mode is only effective wtien 
graphics-mode switch is ON. 
{2) Ttiis- switch lias a diflerenl lunctton 
when the flO'caluinn lexl card's 
auKLliary text pag^ is enabled: for 
wnting. Refer to the next seclioii. 
"■Addressing Display Pages Diredly". 

(3) This switch changes the lunctian of 
the PAGE 2 switch for addressing the 
auxiliary tent memorv on the exlended 
BO-column text card, The next section 
describes how to do this. 

(4) Reading thfs location returns the 
Stale Of ttie vertical blanking 
signal VHL . The tunction ot VBL is 
described in Chapter 7 in the seclian 
"Video Output Signals," 



Some ot the soft switches in Table 2-10 are marked read or 
write. Those soft switches share their locations with the keyboard 
data and strobe functions. In the origifnal Apple II. memory 
locations from *CO0 to*COlF {49iS2 to 491 83) were used only for 
the keyboard data and strobe functions, in the Apple lie, these 
locations are used the same way, but only when you read to get 
data and write to clear the strobe. To perform the function shown 
in the table, use the operation listed there, Soft switches that are 
not marked may be accessed by either a read or a write. When 
writing to a soft switch, it doesn't matter what value you write; 
the action occurs when you address the location, and the value 
ts ignored. 



Name 


Function 


Hex 


Location 
Deci 


mal 


Notes 


fiLTCHARSET 


Alternate char, set on 
Alternate char, set off 
Read ALTCHflRSET switch 


»CO0F 
SCOOE 

«C01E 


49167 
431 6G 
49182 


-16369 
- 1 6370 

-1G3S4 


Wrile 
Write 
Read 


TEXT 


Text mode on 

Text mode off {graphics) 

Read TEXT SwilCh 


*CCS1 
ICD5Q 
«C01 A 


49^33 
49232 
491 7B 


-1B3D3 
-16304 
-16358 


Read 


MIXED 


ftflixed-modeon 
Mixed-mode off 
Read MIXED switch 


9CD53 
tC052 
«C01S 


4923B 
4923^ 
48179 


-16301 
-163C^^ 
-ie357 


1 
1 
Read 



PAGEE Page 2 on 

Page £ ofH;Page 1) 
Read PAGE 12 switch 



1CDS5 43237 -16399 2 
IC054 49236 -16300 2 
iCOlC 49teO -1G356 Read 



H I RES Hi-res mode on 

Hi-res mode OR 
Read HI RES switch 



IC057 49239 -15297 1 
tC(}S6 49238 -16288 1 
• C01 D 491 81 - 1 63SS Read 



eOCDL 


0D-coljmn display on 
BD-columr display off 
Read socuL switch 


fCOOD 

• COOC 

• COIF 


491 6S 
491 G 4 
49183 


16371 
-16372 

-16353 


Write 
Write 
Read 


SOSTaRE 


Store in auxiliary memorv 
Store in main meniory 
Read QQSTDRE switch 


• COOi 

•cooa 

tOQiS 


49153 
49152 
49176 


-16383 
-^6384 
-16360 


Wrile. 3 
Write, 3 
fleaa 



VBt 



Read vertical blanking 



•C019 49177 -163S9 
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Any time you read a soft switch, you get a. byte of daia. 
However, the only information the byte contains is the state of 
the switch, and this occupies only one bit — bit 7, the high-order 
bit. The other bits in the byte are unpredictable. If you are 
programming in machine language, the switch setting is the sign 
bit; as soon as you read the byte, you can do a Branch Pius it 
the switch is off, or Branch Minus it Ihe switch if on. 

If you read a soft-switch from a BASIC program, you get a value 
between and 255. Bit 7 has a vaiue of 128. so if the switch is 
on. the vaiLie will he equal to or greater than 128; if the switch is 
off, the value will be less than 128- 

Addressing Display Pages Directty 

Before you decide to use the display pages directly, consider the 
alternatives. Most highlewel languages enable you to write 
statements that control the te>tt and graphics displays. Similarly, if 
you are programming ;in assembly language, you may be able to 
use the display features of the builMn I/O firmware, Vou should 
store directly into display memory only if the existing programs 
can't meet your requirements. 

The dfspJay memory maps are shown in Figures 2-5, 2-6. 2-7, 
and 2 8. All of the different display modes use the same basic 
addressing scheme: characters or graphics bytes are stored as 
rows of 40 contiguous bytes, but the rows themselves are not 
stored at locations corresponding to their locations on the display. 
Instead, the display address is transformed so that three rows 
that are eight rows apart on the display are grouped together and 
stored in the first 120 locations of each block of 128 bytes {$80 
hexadecimal). By folding the dispiay data into memory this way, 
the Apple Me, like the Apple II. stores ail 960 characters of 
displayed text within 1 K bytes of memory. For a full description of 
the way the Apple lie handles its display memory, refer to the 
section "Display Memory Addressing" in Chapter 7. 

The high-resolution graphics display Is stored in much the same 
way as text, but there are eight times as many bytes to store, 
because eight rows of dots occupy the same space on the 
display as one row of characters. The subset consisthg of all the 
first rows from the groups of eight is stored in the first 1024 
bytes of the high-resolution display page. The subset consisting 
of all the second rows from the groups of eight is stored in the 
second 1024 bytes, and so on for a total of 8 times 1024. or 
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8192 bytes- In other words, each block of 1024 bytes in the high- 
resolution display page contains one row of dots out of every 
group of eight rows. The individual rows are stored in sets of 
three forty-byte rows, the same way as the text display. 

All of the display modes except SO-column mode can use efther 
of two display pages. The display maps show addresses only for 
each Page 1 To obtain addresses for text or low-resoiution 
graphics Page 2. add 1024 (S400); to obtain addresses for high- 
resolution Page 2. add B192 ($2000). 

The ao-coiumn display works a little differently. Half of the data is 
stored in the normal text Page-1 memory, and the other haJf is 
stored in memory on the 80-cotumn text card usfng the same 
addresses. The display circuitry fetches bytes from these two 
memory areas simultaneously and displays them sequentially: 
first the byte from the 80-column text card memory, then the byte 
from the main memory. The main memory stores the characters 
in the odd columns of the display, and the BO-column text card 
memory stores the characters in the even columns. 

To store display data on the 80-column text card, first turn on the 
80STORE soft switch by writing to location 491 53 (hexadecimallCOOi 
Of complementary - 1 G383). With 80 STORE on . the page-select switch 
PAGEP selects between the portion of the 80-column display stored 
tn Page 1 ot main memory and the portion stored in the 80- 
column text card memory. To seiect the 80-column text card, turn 
the PA&E2 soft switch on by reading or wnting at location 49237. 
For more details about the way the displays are generated, see 
Chapter 7, 
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Rgure 2-S Map of 40-coluTnri Text 
Display 
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Rgure 2-6 Map ot fiO-column Text 
Display 
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Figure 2-7 Map of Low-rBsoluMon 

Graphics Dispia^ 
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Figure Z-B Map ot Higln-resolutton 
Graphics Display 
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Secondary Inputs and Outputs 

in addition lo the primary I/O devices — the keyboard and 
display — there are several secondary input and output devices 
in the Apple lie. These devices are 

The speaker (output) 

Cassette input and output 

Annunciator outputs 

Strobe output 

Switch inputs 

Analog (hand control) inputs 

These devices are similar in operatton to the soft switches 
described in the previous section: you control them by reading or 
writing to dedicated memory locations. Action takes place any 
lime your program reads or writes to one of these locatfons; 
information written is ignored. 

Sonne of these devices toggle — change state — each time they 
are accessed. If you write using an indexed store operation, the 
Apple lie's 6502 microprocessor sctivates the address bus twice 
during successive ciock cycles, causing a device that toggies each 
time it is addressed to end up back in its original stale. For this 
reason, you should read, rather than write, to such devices. 



The Speaker 

The Apple lie has a smail speaker mounted toward the front of 
the bottom plate. The speaker is connected to a soft switch that 
toggles: it has two states, off and on. and it changes from one to 
the other each time it is accessed. Eiectrical specifications of the 
speaker circuit appear in Chapter 7, 

If you switch the speaker once, it emits a click; to make ionger 
sounds, you access the speaker repeatedly. Vou should always 
use a read operation to toggle the speaker, If you write to this 
soft switch, it switches twice in rapid succession. The resulting 
pulse is so short that the speaker doesn't have time to respond; 
it doesn't make a sound. 

The soft switch for the speaker uses memory location 49200 
(hexadecimal *ca30). From Integer BASIC, use the complementary 
address -16336. You can make various tones and buzzes with the 
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speaker by using combinations of liming loops in your program. 
There is also a routine in the built-in firmware to make a beep 
tlirough the speaker. This routine is called BELLI ; it is described in 
Appendix C. 



a 



Cassette Input and Output 

There are two miniatijre phone jacks on the back panel of the 
Apple Me. You can use a pair of standard cables with miniature 
phone plugs to conned an ordinary cassette tape recorder to the 
Apple lie and save programs and data on audio cassettes. 

The phone jack marked with a picture of an arrow pointing 
towards a cassette is the output jack. It is connected to a toggled 
soft switch, like the speaker switch described above. The signal 
at the phone jack switches trom zero to 25 millivolts or from 25 
milltvoits to zero each time you access the soft switch. Detailed 
electrical specifications for the cassette input and output are 
given in Chapter 7. 

If you connect a cable from this jack to the microphone input of a y^ 

cassette tape recorder and switch the recorder to record mode, ' 

the signai changes you produce by accessing this soft switch will 

be recorded on the tape. The cassette output switch uses k ^j 

memory location 49184 (hexadecimal tCOsO; complementary value 

-1 635E). Like the speaker, this output will toggle twice if you write 

to itp so you should only use read operations to control the h-'^ 

cassette output. 

The standard method for writing computer data on audio tapes 
uses tones with two different pitches \o represent the binary 
states zero and one. To store data, you convert the data into a 
stream of bits, and convert the bits into the appropriate tones. To 
save you the trouble of actually programming the tones, and to 
ensure consistency among all Apple II cassette tapes, there is a 
built-in routine for producing cassette data output. This routine, 
called WRITE, is described in Appendix C. 

The phone jack marked with a picture of an arrow coming from a 
cassette is the input jack. It accepts a cable from the cassette 
recorder s earphone jack. The signal from the cassette is 1 volt 
(peak-to-peak) audio. Each time the instantaneous value of this 
audio signal changes from positive to negative, or vice-versa, the 
state of the cassette input circuit changes from zero to one or 
vice-versa. You can read the state of this circuit at memory 
location 492-48 (hexadecimal SCOGO, or complementary decimal 
-16268). 
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When you read this location, you get a byte, but only the high- 
order bit (bit 7) is valid. If you are programming In machine 
language, this Is the sign bit, so you can perform a Branch Plus 
or Branch Minus Immediately after reading ihis byte. BASIC is 
too slow to keep up with the audio tones used for data recording 
on tape, but you don t need to write the program: there is a built- 
in routine for reading data from a cassette. It is called READ, and it 
is described in Appendix C. 

The Hand Controf Connector Signals 

Several inputs are available on a 9-pin D-type miniature 
connector on the back of the Apple lie: three one bit inputs, or 
switches, and four analog inputs. These signals are also 
available on the sixteen-pin IC connector on the main circuit 
board, along with four one-bit outputsBnd a data strobe. You can 
access all of these signals from your programs. 

Ordinarily, you connect a pair of hand controls to the 9-pin 
connector. The rotary controls use two analog inputs, and the 
push-buttons use two one-bit inputs. However, you can also use 
these inputs and outputs for many other jobs. For example, two 
analog inputs can be used with a two axis joystick. Complete 
electrical specifications of these Inputs and outputs are given in 
Chapter 7; Table 7-16 shows the connector pin numbers. 

Annunciator Outputs 

The tour one-bit outputs are called annunciators. Each 
annunciator can be used to turn a lamp, a relay, or some similar 
electronic device on and off. For electrical specifications of the 
annunciator outputs, refer to Chapter 7. 

Each annunciator is controlled by a soft switch, and each switch 
uses a pair of memory locations. These memory locations are 
shown in Table 2-11. Any reference to the first location of a pair 
turns the corresponding annunciator off; a reference to the 
second location turns the annunciator on. There is no way to 
read the state of an annunciator. 
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Table 2-1 1 Ann jnciator Memory 
Locations 

"Pin numbers given are for the t6-pin 
IC conneclor on the circuit board. 



Annunciator 
No. Pin' State 



Address 
Declrnal Hex 



15 



off 
on 



492 4Q -16336 

49^41 -1629S 



*C059 



14 



off 
on 



49^42 -16294 
49243 -16293 



I COBB 



2 


13 


Off 

on 


49£44 

4924B 


1629B 

- 1 6291 


ICOBC 

IC05D 


3 


12 


off 
on 


49^46 
49247 


-1 6290 

-16299 


*C05E 

«C05F 
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Strobe Output 

The strobe output is normally at +5 vofts. but it drops to zero for 
aboul half a microsecond any time its dedicated memory location 
is accessed. You can use this signal to control functiohs such as 
data latching in external devices. If you use this signal, 
remember that memory is addressed twice by a write; if you 
need only a single pulse, use a read operation to activate the 
strobe. The memory iocation for the strobe signal is 4921 6 
(hexadecimal iC040 or complementary -16320). 

Switch inputs 

The three one-bit Inputs can be connected to the output of 
another electronic device or to a pushbutton. When you read a 
byte from one of these locations, only the high order bit — bit 
7 — is valid information; the rest of the byte is undefined From 
machine language, you can do a Branch Plus or Branch Minus 
on the state of bit 7. From BASIC, you read the switch with a 
PEEK and compare the value with 128. If the value is 128 or 
greater, the switch is on. 

The memory locations for these switches are 492^9 through 
49E51 (hexadecimal tcoei through »C063, orcomplementary 
-16287 through -16265). as shown in Table 2- 12. Switch 
and s witch 1 are permanently connected to the I open-apple 1 and 
Lsoli d-appleI keys on the keyboard: these are the ones normally 
connected to the buttons on the hand controls. Some software 
for the older models of the AppJe II uses the third switch, switch 
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2p as a way of detecting the shift l<ey. This technique requires a 
hardware modification known as the single-wire shift-key mod. 

To perform this modification on your Apple Ue, all you have to do is 
solder across the broken circle labelled xe on the main circuit board- 
Early production Apple lies, idenlif ed by a circuit board part number 
endmg in A, have the shift-key mod active; you can remoye it by 
breaking the circuit at xe Hemember to turn off the power before 
c)ianging anything inside the Apple He. Also rememt>er that changes 
such as this are at your own risk and may void the warranty. 



Warning 

If you make the shift-key modification and connect a joystick or 
other hand control that uses switch^ you must be careful never to 
close the switch and press the [SHlFf| key at the same time: doing 
this produces a short circuit that causes the power supply ro turn 
off. When this happens, any programs or data in the computer's 
internal memory are lost. 



Analog Inputs 

The four analog inputs are designed for use with 1&0K ohm 
variable resistors or potentiometers. The variable resistance is 
connected between the +5V supply and each input, so that it 
makes up part of a timing circuit (refer to Chapter 7 for details). 
The circuit changes state when its time constant has elapsed, 
and the time constant varies as the resistance varies. Your 
program can measure this time by counting in a loop until the 
circuit changes state, or times out. 

Before a program can read the analog inputs, it must first reset 
the timing circuits. Accessing memory location 49£64 (hexadecimal 
• CQ70 or complementary -1B2 72) does this. As soon as you reset 
the timing circuits, the high bits of the bytes at locations 49252 
through ^925S (hexadecimal *C064through*C067 or complementary 
-1 6284 through -1 6281 ) are set to one. If you peek at them from 
BASIC, the values will be 12B or greater Within about 3 
milliseconds, these bits will change back to zero — byte values 
less than 128 — and remain there until you reset the timing 
circuits again. The exact time each of the four bits remains high 
is directly proportional to the resistance connected to the 
corresponding input. If these inputs are open — no resistances 
are connected — the corresponding bits may remain high 
indefinitely. 

To read the analog inputs Irom machine lar>guage, you can use 
a program ioop that resets the timers and then increments a 
counter until the bit at the appropriate memory location changes 
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Table 2-12 Secondarv i/0 Memory 

Locations 

For connector identificaliun and pin 
numbers, refer to Tables 7-17 and 

7-1 a. 



to zero, or you can use the built-in routine. It is called PREflD, and 
it is described in Appendix C BASIC and otiier high-level 
languages aEso include convenient means of reading the analOQ 

inputs: refer to your language manuals. 

Summary of Secondary UO Locations 

Table 2-12 shows the memorv locations for all of the built-in I/O 
devices except the keyboard and display. As explained above, 
some soft switches should only be accessed by means of read 
operations; those switches are marked. 



Annunciator On 
Annunciator Off 

Annunciator 1 On 
Annunciator 1 Olf 

Annunciator 5 On 
Annuncia!or2 Off 

Annunciators On 
Annunciator 3 Off 



Strobe Output 



Switch Input 



|DPEM-ftPPLE| key) 



Function 


Address 
-""^Decimal Hex 


Notes 


Speaker 


49200 -16336 


tC030 


Read 


Cassette Oul 
Cassette In 


49164 -16352 
49248 -16288 


«C0£0 

tcoeo 


Read 
Read 



492 41 


-16295 


IC0S9 


4924 


-I6?ae 


tcQse 


4924 3 


-1S233 


SC05B. 


492*12 


-16294 


*C05A 


49245 


\e^3\ 


*CQ5I> 


49244 


-16292 


tcosc 



49247 -ie2S9 

4924G 1629D 



»COBF 
SCQSE 



4921 B 16320 »C040 



49249 16287 »C061 



Read 



Read 



Switch Input 1 

((SDLID-APPLE 
Switch Input 2 


J key) 


492S0 
492S1 


-16286 
-16285 


«CD62 

*coe3 


Read 
Read 


Analog Input Reset 

Analog Input 
Analog Input 1 
Analog Input 2 
Analog Inputs 




49264 

49252 
492B3 

4925 4 
4925S 


-16272 

1&284 

-1B283 
-16282 

1&2S1 


«C070 

*CD64 
*C06S 

tcoee 

tC067 


Read 
Read 
Read 
Read 



i 






Um 



&2 



40 



Built-in I/O Devices 



l: 



l: 



L 



Chapter 3 



BuilUin I/O Firmware 



44 Using the I/O Subroutines 

44 Apple II Compatibility 

45 The 80-column Firmware 
47 The Old Monitor 

47 The Standard i;0 Links 

46 Standard Output Features 

48 COUT Output Subroutine 
Control Characters with COUT1 
The Stop-List Feature 
The Text Window 
Inverse and Flashing Tei^t 

53 Standard Input Features 
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Escape Codes with KEYIN 

Cursor Motion in Escape Mode 
GETLN Input Subroutine 
Editing with GETLN 

Cancel Line 

Backspace 

Retype 



50 
50 
50 
52 



54 
55 

56 
56 
58 
58 

58 

58 
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The Monitor, or S/st&m Monitor, is a 
compulof progrEm tliat is used to 
operate the compulBr &\ ihe machine 

level 



Table 3-1 Standard I/O Subroutines 
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Almost every program on the Apple Me takes input from the 
keyboard and sends output to the display. The Monitor and the 
Applesoft and Integer BASICS do this by means of standard I/O 
subroutines that are built into the Apple He s firmware. Many 
applications programs also use the standard I/O subroutines, but 
programs written in Pascal do not; Pascal has its own I/O 
subroutines. 

This chapter describes the features of these subroutines as they 
are used by the Monitor and by the BASIC interpreters, and tells 
you how to use the standard subroutines in your assembly- 
language programs. 

High-level languages already include convenient methods for 
handling most of the funclions described in this chapter. You should 
not need to use the standard I/O subroutines in your programs 
unless you are programming in assembly language. 



Subroutine 
Name 



LocaUon 



Description 



COUT 
RDKEY 

KEVIN 
GETLN 



tFDED 
tFDQC 

JFDIB 

tFDGfl 



Character Out: sends a character to the display. 

Read Key; displays ihe blinking cursor; goes to the 
standard input routine, normally <EV IN. 

Key In: with aO-column finnware active, displays 
checkerboard cursor. Accepts a character trom the 
keyboard. 

Gel Lirei drsplays the prompt character; accepis a 
sequence of characlers by means oi RDKEiY. 



Buitt-in 1/0 Firmware 



43 



Table 3-2 Apple 11 Mode 



The standard I/O subroutines listed in Table 3-1 are fully 
described in this chapter. The Apple Jle ffrmware also contains 
many other subroutines that you might find useful. Those 
subroutines are deschbed in Appendix C Two ol the built-in 
subroutines, AUXMOVE and XFER^ can help you use the optional 
auxiliary memory; those subroutines are described in Chapter 4. 

Using the 110 Subroutines 

Before you use the standard I/O subroutines, you should 
understand a little about the way they are used. The Apple He 
firmware operates differently with different options such as the 
80-cofumn text card. This section describes general situations 
that affect the operation of the standard I/O subroutines. Specific 
instances are described in the sections devoted to the individual 
subroutines. 

Appte U CompatibiUty 

Compared to older Apple II models, the Apple lie has some 
additional keyboard and display features. To run programs that 
were written for the older models, you can make the Apple lie 
resemble ar\ Apple II Plus by tuming those features off. The 
features that you can turn off and on to put the Apple lie into and 
out of Apple II mode are listed in Table 3-2. 



Apple Ue 



Apple II Mode 



Keyboard: Uppercase and lowercase Uppercase only 

Display Cfiaiaclers: Inverse and norniat only 



Display size: 



40-coljmn; also 
SO-column, with opt^o^a! 
card 



Flashing, Inverse, and 

normal 

40-columr only 



If the Apple He does not have an BO-column text card installed in 
the auxiliary slot, it is almost in Apple 11 mode as soon as you 
turn it on or reset it. One exception is the keyboard, which Is 
both uppercase and lowercase To be compatible with older 
software, you have to switch the Apple lie keyboard to uppercase 
by pressing the [ cftPS lock ] key. 
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statements in App lesoft a nd Int eger BASIC must be typed In 
uppercase letters. | cftPS l dckH will take care of this, but It makes It 
inconvenient to use lowercase letters in PRINT statements. If the 
BO-column firmware is active (see below), you can use 
uppercase- rest rid mode, which forces typed letters to uppercase 
except inside quotation marks (see Table 3-6). 

Another feature ttiat is different on the Apple lie is thie displayed 
character set. Older Apple lis display only uppercase characters, 
but they display them three ways; normaL inverse, and flashing. 
The Apple He can display uppercase characters all three ways, 
and it can display lowercase characters in the normal way. This 
combination is called the primary character set. When the 
Apple lie is first turned on or reset, it displays the primary 
character set 

The Apple lie has another character set, called the alternate 
character set, that displays a full set of normal and inverse 
uppercase and lowercase characters^ but can't display flashing 
characters. The primary and alternate character sets are 
described in Chapter 2 You can switch character sets at any 
time by means ot the ALTCHARSET soft switch, also described in 
Chapter 2. 

The BO'Column Firmware 

There are a few features that are normally available only with the 
optional eO-column display. These features are identified in 
Tables 3-3a and 3-3b and Table 3-6. The firmware that supports 
these features is built into the Apple lie, but It is normally active 
only if an 80-column text card is installed in the auxiliary slot. 

When you turn on power or reset the Apple Me, the 80-co3umn 
firmware is inactive and the Apple lie displays the primary 
character set, even if an 80-column text card is installed. When 
you activate the SO-column firmware as described below, it 
switches to the alternate character set. 

The built-in 80-column firmware is implemented as if it were 
installed in expansion slot 3- Programs written for older Apple Ms 

with eo-column display cards installed in slot 3 will run properly 
on an Apple Me with an QO-column text card. 
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If Ihe Apple Me has an 80-column text card and you want to use 
the eO-column display, you can activate the built-in firmware from 
BASIC by typing 

PR' 3 

To act ivate ttie eo -column firmware from the Monitor, type 3 and 
press [ control] -P. Notice that this is the same procedure you 
use to activate a card in expansion slot 3 Any auxiliary card 
installed in the auxiliary slot takes precedence over a card 
installed in expansion slot 3: see the section "Switching I/O 
Memory ' in Chapter 6 for details. 

Eyen though you activated the BO-column fimiware by typing pr'3, 
you should never deactivate It by typing pr*0, because ttiat Just 
disconnects the firmware, leaving several soti swi tches still set for 
ao-CQlumn operation. Instead, type the sequence ! ESC | [ C DtHTHDj^[ -Q 
(see Table 3-6). 

If there is no 80-column text card in your Apple lie, you can still 
activate the BO-column firmware and use it with a 40-column 
display. First, set the IKTcaRDK soft-switch located at 
»COOA ('iaiGS); this switch is described in Chapters in the section 
"Switching I/O Memory". Then type PR'3 to transfer control to the 
firmware. 

When the BO-column firmware is active without a card in the 
auxiliary slol, it does not work quite the same as it does with a 
card. The functions that cfear the display (clreol, cledlz. 
CLREOP, and hd^e) work as it the firmware were inactive: they 
always clear to blacks even in inverse format. Also, interrupts are 
locked out throughout long operations such as clearing the 
display. With a card installedK the firmware enables interrupts 
periodically during these long operations. 

Warning 

If you do not have either an SO-column text card in the auxiliary slot 

or a terminal card of some kind in expansion slot 3, don't try to 
activate the firmware by simply typing pr'3, Typing PR '3 with no card 
installed transfers control to the empty connector with unpredictable 
results, 

Programs activate the SO-column firmware by transferring control 
to address *C3Q0. If (here is no card in the auxiliary slot, you must 
set the iNTCBRQn soft switch first. To deactivate the eo-column 
firmware from a program, write a [ cqmtrdl1 -u character via 
subroutine COUT. 
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The Old Monitor 

The older model Apple lis and Apple il Pluses inducted a different 
version of the System Monitor. It had the same standard I/O 
subroutines, but a few of their features were different: for 
example, there were no arrow keys for cursor motion. When you 
start the Apple lie with a DOS or BASIC disk and it loads Integer 
BASIC into the bank-switched area in RAM. it loads the old 
Monitor (sometimes called the Autostart t^onitor) along with it. 
When you type INT from Applesoft to activate Integer BASIC, you 
also activate this copy of the old Monitor, which remains active 
until you either type FP to switch back to Applesoft, which uses 
the new tyionitor in ROM, or type 

PR#3 

to activate the 80-column firmware. Part of the firmware's 
initialization procedure checks to see which version of the 
Monitor is in RAM. If tt finds the oid Monitor, it replaces it with a 
copy of the new Monitor from ROM. After the firmware has 
copied the new Monitor into RAM, it remains there until the next 
time you start up the system. 

The Standard 110 Links 

When you call one of the character I/O subroutines (cauT and 
RDKEY). the fiirst thing that happens is an indirect jump to an 
address stored in programmable memory. Memory locations used 
for transferring control to other subroutines are sometimes called 
vectors; in this manual, the locations used for transfemng controt 
to the 3/0 subroutines are called (he t/O links In a Apple He 
running without a Disk Operating System, each I/O link is 
normally the address of the body of the subroutine (CQUTi or 
KEVIN). If a Disk Operating System (DOS) is running, one or both 
of these links hold the addresses of the corresponding DOS I/O 
routines instead. {DOS maintains its own links to the standard 
I/O subroutines.) 

By calling the I/O subroutines that jump to the link addresses 
instead of calling the standard subroutines directly, you ensure 
that your program wiil work property in conjunction with other 
software, such as DOS or a printer dnver, that changes one or 
both of the I/O links. For the purposes of this chapter, we shail 
assume that the I/O links contain the addresses of the standard 
I/O subroutines COUTi and KEv tH, For more information about the 
I/O links, see the section "Changing the Standard I/O Links'" in 
Chapter S. 
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Table 3.3h Control Characters with 

CDUT1. 

(1 1 Only available when SO-columr 
fiprnwafe is active. 

(2) Only iworks from the keyboard . 

(3) DMSnt work from the keyboard. 



Standard Output Features 

The standard output routine is named CDUT, pronounced C-out, 
which stands tor character out. cauT normally calls CDUTi , which 
sends one character to the display, advances the cursor position, 
and scrolls the display when necessary. cOUTi restricts its use of 
the display to an active area called the text window, described 
below. 



COUT Output Subroutine 

Your program makes a subroutine call to *fdED with a character 
in the accumulator CQUT then passes control via the output link 
CSW to the current output, normally cduti, which takes the 
character in the accumulator and writes it out. If the accumulator 



rcQNTRaLj - L (FF) clear 



|_C DNTROl| - M (CR) relurn 



I COHTRflL] - N 

|cdntrql{ - D 



CONTROL - Q 



COMTROL - R 



CONTROL - S 



(50) normal 

(51) inverse 
(DCi) 4a-coiumn 
(DC2) aQ-column 
(DS3) stop-lisi 



Moves cursor position to 
upper-letl comer of window and 
cl&ars window. 

Moves cursor position to leW 
end oi next line in window; 
scrolls if needed. 

Sets display fomiat normal. 

Sets display foirnat inverse. 

Sets display to 40-calumn. 

Sots display lo QO-cotumn-l 



1,3 

1.3 
1 



Stops sending cliaracters to I he 1,2 
display, until a hey is pressed. 



4& 
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Control 
Cha racier 




ASCII 
Name 


Apple tie 
Name 


Action Motes •^ 
Taken by C0UT1 1^ 




■ G 

- H 

- J 

- K 


[BED 
(68} 

tLF) 

(\n-i 


bell 
backspace 

line feed 
clear EOS 


Produces a 1000 Hz tone for 
0.1 second. 

Moves cursor position one 
space to the left: Irom left edge 
of window, moves to rig lit end 
of line above. 

Moves cursor posilion down to 
next line in window; scrolls if 
needed 

Clears from cursor position to 1 

the end of the window- 




ICQMTROLl 


^ 


ICHNTRDLj 


P 


icaNTRQLl 


h^ 


[ CONTROL 1 


li— 







1 



l: 
l: 

l: 
l: 
l; 

l: 

L 
L 



contains an uppercase or lowercase letter, a number, or a 
speciai character, the accumulator contarns a control character. 
caUTi eittier performs one of the special functions described 
below or ignores thie character. 

Each time you send a character to CDUTi , it displays the character 
at the current cursor positron, replacing whatever was there, and 
then advances the cursor position one space to the right. If the 
cursor position is already at the right-hand edge of the window, 
CDUTI moves it to (he left-most position on the next line down. It 
this would move the cursor position past the end of the last line 
in the window, couTi scrolls the display up one line and sets the 
cursor position at the left end of the new bottom line, 



Table 3-3b Control Characters wH^h 
COUTi , continued 


Control 
Character 




ASCII 
Name 


Apple ille 
Name 


Action Taken by C0UT1 


Notes 


[1 ) Only available when SO-column 




■ U 
- ^ 

■ Y 

■ z 

■ \ 

■f 


(NAK) 

(ETB) 
(EM) 

(SUB) 

(FS) 

(GS) 

(RS) 


quit 
scroll 

seroH-up 

tiome 

clearlfne 
Iwd. spac« 

clear EOL 
gotoXY 


Deactivates flO^cdumn 

fimnware, homes cursor, 
and dears screen, 

Scrolls the display down 
one line, leaving ttie cursor 
m thecurreni position. 

Scrolls the display' up one 
line, leaving \he cursor In 
the cu.rrenl position. 

Moves cjrsor position to 
upper-ien corner o( window 
(but doesn't clear). 

Clears the line ttie cursor 
position is ori_ 

Moves cursor position one 
space to the right: from 
right edge of window. 
moves it to left end of lino 

below. 

Clea/5 ijne from cursor 
position to the right edge of 
the window. 

Using the next two 
characters, minus 32. as 
one Dyte X and Y values, 
moves the cursor position 
toCH = X, CV=Y. 




firmware is active. 
(2) gotoXY is rol suppO'led under 
BASIC: see Ihe Apple Pascal 
Operating System Refarefice Manuat. 


1 caHTROLJ- 


1 




] CDMTROLt- 


1 




jCDMTBOLl' 


1 




1 CQHTROL 1 - 


1 




1 CONTROL 1 - 


1 




[caHTRDLl - 


1 




1 CONTROL 1 - 


1 




1 CONTROL 1- 


1,5 
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The Text Window 

After starting up the computer or after a reset COUTi uses the 
entire dispiay. However, you can restrict CDUTi's activity to any 
rectangular portion of the display you wish. Tfie active portion of 
the display is called the text window. COUT1 puts characters only 
into the window; when it reaches the end of the last line in the 
window, n scrolls only the contents of the window. 






Urn 



The cursor position is controlled by the values in memory I 

locations 36 and 3? (hexadecimal »24 and *25). These locations J 

are named CH, for cursor horizontal, and CV. for cursor vertical. ^j^ 

COUT1 does not display a cursor, but the input routines descnbed | 

below do, and they use this cursor position. If some other routine ^ 

displays a cursor, it will not necessarily put it in the cursor y^ 

position used by COUTI . 1 

Controi Characters with CDUT1 

COUT1 does not display control characters. Instead, the control 
characters listed in Tables 3 3a and 3'3b are used to initiate 
some action by the firmware. Other control characters are 
ignored. Most of the functions listed here can also be invoked 
from the keyboard, either by typing the control character listed or 
by using the appropriate escape code, as described in the 
section "Escape Codes with KEYIN'. The stop-list function, 
described separately, can only be invoked from the keyboard. 

The Stop'tist FeaturB 

When you are using any program that displays text via cOUTi , you 
can make it stop updating the display by holding down the 
r cDNTROLl key and pressing the S i^ey. Whenever CDUTi gets a 
carriage retu rn from the program, it checks to see if you have 
typed a fcaNTRDLl -S . It you have, CDUTi stops and waits for you to 
press another key, When you want CQUTI to resume, press 
another key; COUTi will send the carnage return it got earlier to 
the display, then continue normally. The character code of the 
key you pressed to resume displayi ng is i gnored unless it is a 
r cDMTRDL> c COUTI passes rcMTRPLl - c back to the program; if 
it is a BASIC program, this enables you to terminate the program 
while in slop-list mode. 



J 
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You can set the top, bottom, left side, and width of the text 
window by storing the appropriate values into lour locations in 
memory. This enables your programs to control the placement of 
text in the display and to protect other portions of the screen 
from being written over by new text. 

Memory location 32 (hexadecimal $20) contains the number of the 
leftmost column in the text window. This number is normafly 0. 
the number of the leftmost column in the display. In a 40-column 
display, the maximum value for this number is 39 {hexadecimal 
S27); in an SO-column display, the maximum value is 79 
(hexadecimal $4F). 

Memory location 33 (hexadecimal *£1 ) holds the width of the text 
window. For a 40-uolumn display, it is normally 40 (hexadecimal 
$28); for an 80-column display, it is normally 80 (hexadecimal 
$50). CDUTi truncates the width to an even value. 

Warning 

Be carefyi not (o let the sum of the window width and the leftmost 
position in the window exceed the width of the display you are using 
[40 or 80). If thfs happens, it is possible for cuuTi to pui characters 
inio memory locations outside the display page, possibly destroying 

programs or data. 

Memory location 31 (hexadecimal *2£) contains the number of the 
top line of the text window. This is normally 0, the topmost line in 
the display. Its maximum value is 23 {hexadecimal Si 7). 

Memory location 3S {hexadecimal *23) contains the number of the 
bottom line of the screen, plus 1. It is normally 24 (hexadecimal 
$18) (or the bottom line of the dispfay. Its minimum value is 1. 

Warning 

Any time you change the boundaries of the text window, you shoL/ld 
make sure Ihat the current cursor position (stored at ch and cv) is 
inside the new window. II it is outside, it is possible far cDUTi to put 
characters into memory locations outside the dispiay page, possibly 
destroying programs or data, 
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Table 3-4 Text Window Memory 
Locations 




















Window 
Parameter 


Location 
Dec Hex 


Minimum 

Value; 
Dec Hex 


Norinel Values: 
40cD^ SCteoL 
Dec Hex Dec Hex 


Maximum Values; 
40coL BOcoF. 
Dec Hen Dec Hex 


Left Edge 


32 


120 





$0 


□ 


$0 





$0 


39 


$27 


79 54F 


Width 


33 


t21 





so 


40 


526 


BO 


S50 


40 


$26 


ao S50 


Top Edge 


34 


*22 





so 





$0 





$0 


23 


$17 


23 $17 


Bottom Edge 


3S 


*23 


1 


SI 


24 


sia 


24 


$ia 


24 


$ia 


24 $ie 



Table 3-4 summarizes the memory locations and the possible 
values for the window parameters. 



Inverse and Flashing Text 

Subroutine CQUTi can display text in normal format, inverse 
format, or, with some restrictions, flashing format. The dispfay 
format for any character in ttie display depends on two things: 
the character set being used at the moment, and the setting of 
the two high-order bits of the character's byte in the display 
memory. 

As it sends your text characters to the display. COUTi sets the 
high-order bits according to the value stored at memory location 
50 (hexadecimal «3^), If that value is 255 (hexadecimal $FF), 
C0UT1 sets the characters to display in normal format; if the value 
is 63 (hexadecimal S3F), COUTi sets the characters to inverse 
format. If the value is 127 (hexadecimal $7F) and if you have 
selected the primary character set. the characters will be 
displayed in flashing format Note that flashing format is not 
available in the alternate character set. 

To control the display format of the characters, routine COUTi uses 
the value at location 50 as a logical mask to force the setting of 
the two high-order bits of each character byte it puts Into the 
display page. It does this by performing the logical ftHD function 
on the data byte and the mask byte. The resuEl byte contains a 
in any bit that was in the mask. The version of couTi in the 80- 
coiumn firmware changes only the high-order bit of the data 



a 

a 
3 



g 



a 
-J 
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Table i-5 Text Format Control Values 

Nole: These masK vatues apply only lo 
Ihe primary character set (see text)- 



Mask value 
Dec Hex 



Display form at 



255 


SFF 


127 


S7F 


63 


S3F 



Normal, uppercase and towercase 
Flashing, uppercase and synibols 
Inverse^ uppercase and lowercase 



If tiiB SO-cxjIumn firmware is inactive and you store a mask value at 
IcKation 50 with zeros in its low-order bits, cQUTi will mask out thtose 
bits in your teKt. As a result, some characters will be transformed 
into other characters. You should set the mask only to the values 
given in Table 3-5, 

If you set the mask value at location SO to 127 (hexadecimal 
S7F), the high-order bit of each result byte will be 0, and the 
characters will be displayed either as lowercase or as flashing, 
depending on which character set you have selected. Refer lo 
the tables of display character sets in Chapter 2. In the primary 
character set, the next-highest bit. bit 6. selects flashing forrrat 
with uppercase characters. With the primary character set you 
can display lowercase characters in normal format and uppercase 
characters in normal, inverse, and flashing formats. In the 
alternate character set, bit 6 selects lowercase or special 
characters With the alternate character set you can display 
uppercase and lowercase characters in normal and inverse 
formats. Switching between character sets is described in the 
section "Display Mode Switchtng" in Chapter 2. 

Standard Input Features 

The Apple He's firmware includes two different subroutines for 
reading from the keyboard One subroutine is named RDKEY, which 
stands for read key. It calls Ihe standard character input 
subroutine KEVIN, which accepts one character at a time from the 
keyboard. The other subroutine is named oetlH-, which stands for 
get line By making repeated calls to RDKEV. GETLN accepts a 
sequence of characters terminated with a carriage return. GETLN 
also provides on-screen editing features: see the section "Editing 
with GETLN". 
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RDKEY tnput Subroutine 

A program gets a character from the keyboard by making a 
subroutine call Iordkey at memory location sfdoc. rdkev sets the 
character at the cursor position to flash, then passes control via 
the input link ksw to the current input subroutine, which Is 
normally KEVIN. 

RDKEY displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to 
the display (normally by using the GOUT routine, described above). 
The cursor displayed by RDKEV is a flashing version of whatever 
character happens to be at that position on the screen. It is 
usually a space, so the cursor appears as a blinking rectangle. 

The method RDkey uses to display a cursor works as it did on the 
older modeJ Appfe lis, which don't display lowercase characters. 
If you are running an Integer BASIC program with the 80-column 
firmware inactive, the RDKEV-style cursor is still appropriate. With 
lowercase characters or with the alternate character set, this 
method of displaying a cufsor is no longer satisfactory. 

KEVIN Input Subroutine 

KEVIN is the standard input subroutine. When called, it waits until 
the user presses a key, then returns with the key code in the 
accumulator. 

The problem of displaying a cursor without using flashing format 
is handled by keytn. if the 80-column firmware is inactive, KEY IN 
displays a cursor by alternately storing a checkerboard block *n 
the cursor focation, then storing the original character, then the 
checkerboard again, it the firmware is active, KEVIN displays a 
steady inverse space (rectangle), unless you are in escape 
mode, when it displays a plus sign ( + ) in inverse format, 
(Escape mode is described in the next section.) 

KEY IN also generates a random number. While it is waiting for the 
user to press a key, key in repeatedly increments the 16-bit 
number in memory locations 78 and 73 (hexadecimal *4E and *''F), 
This number keeps increasing from to 65535, then starts over 
again a1 0. The value of this number changes so rapidly that 
there is no way to predict what it will be after a key is pressed. A 
program that reads from the keyboard can use this value as a 
random number or as a seed for a pseudo-random number 
routine. 
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Table 3HB Escape Codes 

(1 ) Old-style curBor-cortfol key: see 
texl. 

(2) CufSor-OOntrnJ key: see text 

(3) This code functions only when the 

80"Co]Lmn firmware is active. 



When the user presses a key, key IN accepts the character, stops 
displaying the cursor, and returns to the calling program with the 
character in the accumulator. 

Escape Codes with KEVIH 

KEVIN has many special functions that you invoke by typing 
escape code s on th e keyboard. An escape code is obtained by 



pressing the 1 esc \ key, reieasina it. and then pressinp some 
other key, as shown in Table 3-6. The notation in the (able — 
1 EBC J ' — means press the | £SC J key, release it, Ihen press the 
character that follows. 


Escape Code 




Function 


Not«s 






Clears Ihe window and homes the cursor 

Moves the cursor up one line 

Moves the cursor right one space 

Moves the cursor left one s^ace 

Moves the cursor down one line 

Clears to the end of the line 

Clean's to the bottom of the wlndnw 

Moves the cursor up one lire and (urns on 
escape mode 

Moves the cursor teft one space and turns on 
escape mode 

Moves the cursor right one space and turns on 
escape mode 

Moves the cursor down one line and turns on 

escape mode 

Tumg on restricted-case mode 

Turns off restricted-case mode 

Switches to 40-column mode, homes the 
cursor, and clears the screen 

Switches to BO-cotumn mode, homes ihe 
Cursor, and clears the screen 

Deactivates the ao-coiurrtn finnware 




1 ESC |@ 








1 ESC 1 A 


1 






1 ESC 1 B 


1 






1 ESC 1 C 


1 






1 ESCj D 


1 


1 ESC J E 








1 ESC 1 F 








1 ESC 1 I 


2 






iiscjf 








1 ^^c 1 J 


2 






1 ESC \^- 








1 ESC 1 < 


2 






1 ESC]-+- 








LESCJM 


2 


1 ESC 1 j 








1 ESC 1 R 


3 






L^SCJT 


3 


1 ESC 1 4 


3 


~^ 




1 ESC 1 3 


3 






1 ESC ] [CDNTiSa 


Lj-a 


3 
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Table 3-6 inclu des th ree sets of cursor-conlrol keys. The first set 
consists of the (_EScJ key followed by A, B, c, or D. The letter keys 
can be either uppercase or lowercase. These keys are the 
standard cursor-motion keys on older Apple II models: they are 
present on the Apple Ife primarily for compatability with programs 
written for old machines, 

Cursor Motion fn Escape Mode 

The second and third set ot cursor-control keys are listed 
together because they activate escape mode. In escape mode. 
you ca n keep using the cursor-motion Keys without pressing the 
["esc I key again. This enables you to perform repeated cursor 
moves by holding down the appropriate key. 

When the SO-column firmware is active, you can tell when key IN 
is in escape mode: it displays a plus sign in inverse format as 
the cursor. You leave escape mode by typing any key other than 
a cursor-motion key. 

The escape codes with the directional arrow keys are the 

standard cursor motion keys on the Apple He. The escape codes 

with the ] , J, K, and m keys are the standard cursor-motion keys 

on the Apple II Plus, and are present on the Apple lie for 

compatability with the Apple li Plus. On the Apple lie, the escape IJ!^^ 

codes with the 1 , J, K, and ri keys function with either uppercase 

or lowercase letters. 

GETLM Input SutroutinB 

Programs often need strings of characters as input. While it Is 
possible to call rdkey repeatedly to get several characters from 
the keyboard, there is a more powerful subroutine you can use. 
This routine is named getln, which stands for get iine, and it 
stans at location $FD6A. Using repeated calls to RDkEV, getlm 
accepts characters from the standard input subroutine — usually 
KEY IN — and puts them into the input buffer located in the 
memory page from *20D to *£FF. getln also provides the user with 
on-screen editing and control features, described below in the 
section Editing with qETln". 

The first thing oeTln does when you call it is display a prompting 
character, called simply a prompt. The prompt indicates to the 
user that the program is waiting tor input. Different programs use 
different prompt characters, helping to remind the user which 
program is requesting the input. For example, an Input statement 
in a BASIC program displays a question marl< ( ? ) as a prompt. 



3 



56 Built-in I/O Ftrmware 



J 

a 
'J 

'J 



c 

l: 

l: 
l: 
l: 
l: 
l: 
l: 
l: 

L 



Table 3-7 Prompt Characters 
*Note; Mini -assembler is available only 
with \ntsg^t BASIC active. 



The prompt characters used by the different programs on ihe 
Apple He are shown in Table 3-7, 

GETLN uses the character stored at memory location (hexadecimal 
•33) as the prompt character. In an assembly-language program. 
you can change the prompt to any character you wish. In BASIC, 
changing the prompt character has no effect, because both 
BASIC interpreters and the Monitor restore it each time they 
request input from the user. 



Prompt 
Character 


Program Requesting input 


7 


User's BASIC progfam {INPUT statement) 


> 


Integer BASIC 


] 


Applesoft BASIC 


* 


Firmware Monitor 


1 


Mini-assembler* 



As the user types the character string. GETLN sends each 
character to the standard output routine — normally cduti -^ 
which displays it at the previous cursor position and puts the 
cursor at the next available position on the display, usually 
immediately to the right. As the cursor travels across the display, 
it indicates the position where the next character will be 
displayed. 

GETLN stores the characters in its buffer, starting at memory 
location «ZOO and using the X register to index the buffer. GETLN 
con tinues to a ccept and display characters until the user presses 
the I RETURN ] key; then it clears the remainder of the line the 
cursor is on, stores the carriage-return code in the buffer, sends 
the carriage- return code to the display, and returns to the calling 
program. 

The maximum line-length that GETLN can handle is 255 characters. 
If the user types more than this. GETLN sends a backslash (\ )and 
a carriage return to the display, cancels the line It has accepted 
so far, and starts over. To warn the user that the line Is getting 
full. GETLN sounds a bell (tone) at every keypress after the 24eth. 
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In Ihe Apple II and the Apple H Plus, the geTlh routine converts all 
inputs to upperease OETln in the Apple He does not do this, even in 
Apple II mode. To get uppercase input tor BASIC, use (he 

CAPS LDCK key or sw^lch to restricted-case mode using the escape 
sequence shown in Table 3-6. With restricted-case acttve, ietters are 
automatically shifted to uppercase except inside quotation marks. 



Editing with GETLN 

Subroutine getln provides the standard on-screen editing features 
used by the BASIC interpreters and the Monitor For an 
introduction to ediling with these features, refer to the Applesoft 
Tutoriai. Any progrann that uses GETLN tor reading the keyboard 
has these features. 

Cancer Line 



Any time you are typing a line, pressing 



CDNTRQL ] -x causes 
and 



GETLN to cancel the line, getln displays a backslash (/ 
issues a carriage return, then displays the prompt and waits for 
you to type a new line. GETLN takes the same actton when you 
type more than 255 characters, as described above. 

B&cHspace 



the backspace function. When you press the[RiQ HT^ARROM [ key, 
GETLN picks up the character at the display position just as if it 
had been typed on the keyboard You can use this procedure to 
pick up characters that you have just deleted by backspacing 
across them- You can use the backspace and retype functions 
with the cursor-motion functions to edit data on the display {see 
the earlier section "Cursor Motion in Escape Mode"). 
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When you press the | LEFT-flRRDUi J key, getln moves its buffer 
pointer back one space, effectively deleting the last character in 
its buffer. It also sends a backspace character to routine COUT. 
which moves the display position and the cursor back one space. 
If you type another character now, it will replace the character ^ 

you backspaced over, both on the display and in the !ine buffer. ^^ 

Each time you press the | LEFT-ftRRaw ] key, it moves the cursor left — 
and deletes another character , until you re ach the beginning of 

the line. If you then press the [ LEFT-ARRb^ key one more time, j j 

you have effectively cancelled the line, and GETLN issues a — 

carriage return and displays the prompt. 

Retype ~* 

The [RlGHT^ fl RRDliJ | key has a function that is complementa ry to _J 
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Chapter 4 



Memory Organization 




The Apple lie's 6502 microprocessor can address 65,536 {64K) 
memory locations (K stands for 1024; refer to the glossary). All of 
the Apple lie's programmabte storage (RAM, for random-access 
memory), read-only storage (ROM, for read-only memory) and 
input and output devices are allocated locations in this 64K 
address space. Some functions share the same addresses — but 
not at the same time. For information about these shared 
address spaces, see the section '■8ank-switched Memory" in this 
chapter and the sections "Other Uses of I/O Memory Space" 
and "Expansion ROM Space" in Chapter 6. 

All input and output in the Apple lie is memory mapped. In this 
chapter, the I/O memory spaces are described simply as blocks 
of memory. For details of the built-in I/O features, refer to the 
descriptions in Chapters 2 and 3. For information about I/O 
operations with peripheral cards, refer to Chapter 6, 

People often refer to the Apple lies memory in 256-byte blocks 
called pages One reason for this is that a one-byte address 
counter or index register can specify one of 256 different 
locations. Thus, page consists of memory locations from to 
£55 (hexadecimal *0 to sff), incSusive. Page 1 consists of 
locations 25G to 51 1 (hexadecimal Jt QO to *i FF — note that the 
page number is the high-order part of the hexadecimal address). 
Don't confuse this l<ind of page with the display buffers in the 
Apple Jle. which are sometimes referred to as Page 1 and 
Page 2. 

Main Memory Map 

The map of the main memory address space in Figure 4-1 
shows the functions of the major areas of memory. For more 
details on the I/O space from 4SK to S2< {*cooo through «CFFF), 
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Figure 4-1 Eysteim Memorv Map 



refer to Chapter 2 and Chapter 6; the bank-switched memory in 
the memory space from 52K to 64K (*O000 through «FFFF) is 
described below. 



FFFF 






BANK- 




ROM 




SWITCHED 
RAM 


DOOO 








CFFF 
CGOO 




10 




BFFF 






BOOO 






7FFF 








MAIN 






RAM 


4Q00 






3FFF 




0000 
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Figure 4-2 RAM Allocalion Map 



BFFF 



6000 



7FFF 



6000 



5FFF 



4000 



3FFF 



2000 



1FFF 



0000 



ge I 



High-resoJution 
display butFers 



f'age 2 I Text and lowresoJuMon 

i^££j Page 1 f graphics display buffers 

^ Reserved pages 




RAM Memory Allocation 

As Figure 4-1 shows, the major portion of the Apple He's memory 
space is allocated to programmable storage (RAM). Figure 4-2 
shows the areas allocated to RAM. The main RAM memory 
extends from Jocation to location 491 51 (hex «bfff), and 
occupies pages through 191 (hexadecimal $BF). There is also 
RAM storage in the bank switched space from 53248 to G5535 
{hexadecimal *D00o to *ffff), described in a separate sectfon of 
this chapter, and auxiliary RAM on the 80-column text card or the 
extended SO-column text card, described fn Chapter 6 

Reserved Memory Pages 

Most ot the Apple Ife's RAM is available for storing your 
programs and data. However, a few RAM pages are reserved for 
the use of the Monitor firmware and the BASIC interpreters. The 
reserved pages are described below. 

The system does not prevent your using these pages, but if you do 
use them, you must be careful not to disturb the system data they 
contain, or yau will cause the system to malfunction. 
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Page Zero 

Several of the 6502 microprocessor's addressing modes require 
the use of addresses in page zero, also called zero page. The 
Monitor, the BASIC interpreters, and DOS all make extensive use 
of page zero. 

To use indirect addressing in your assembly-language programs, 
you must store base addresses in page zero. At the same time, 
you must avoid inteilering with the other programs that use page 
zero — the Monitor, the BAStC interpreters, and the Disk 
Operating Systems. One way to avoid conflicts is to use only 
those page-zero locations not already used by other programs. 
Tables 4-1 , 4-2, 4-3, and 4-4 show the locations in page zbtq 
used by the Monitor, Applesoft BASIC. Integer BASIC, and 
DOS 3.3. 

As you can see from the tables, page zero is pretty well used 
up. except for a few bytes here and there. It's hard to find more 
than one or two bytes that aren't used by either BASIC or the 
Monitor or DOS. Rather than trying to squeeze your data into an 
unused corner you may prefer a safer alternative: save the 
contents of part ot page zero, use that part, then restore the 
previous contents before you pass control to another program. 

The 6502 SUck 

The 6502 microprocessor uses page 1 as the stack — the place 
where subroutine return addresses are stored, in first-in, last-out 
sequence. Many programs also use the stack for temporary 
storage of the registers {via push and pull operations). You can 
do the same, but you should use it sparingly. The stack pointer 
is eight bits long, so the stack can hold only 256 bytes of 
information at a time. When you store the 257th byte in the 
stack, the stack pointer repeats itself, or wraps around, so that 
the new byte replaces the first byte stored, which is now lost. 
This writing over old data is called staci< overllow, and when it 
happens, the program continues to run normally until the lost 
information is needed, whereupon the program terminates 
catastrophically. 

The Input Buffer 

The GETLN input routine, which is used by the Monitor and the 
BASIC interpreters, uses page 2 as its keyboard-input buffer. 
The si^e of this buffer sets the maximum size of input stnngs. 
(Note; Applesoft only uses the first 237 bytes, although it permits 
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you to type all 256.) If you know that you wont be typing any 
long input strings, you can store temporary data at the upper end 
of page 2. 

Link-Address Storage 

The Monitor and DOS 33 both use the upper part ot page 3 for 
link addresses or vectors. Table 4-10 shows the part of page 3 
the Monitor uses; refer to the DOS Martuaf to see how DOS 
uses page 3. 

BASIC programs sometimes need short machine-language 
routines. These routines are usually stored in the lower part of 
page 3. 

ThB Dispiay Buffers 

The primary text and low-resolution-graphics display buffer 
occupies memory pages 4 through 7 (locations i 024 through £047. 
hexadecimal (0400 through J07FF). This entire 1024-byte area is 
called display Page 1 . and it is not usable for program and data 
storage. There are 64 locations in this area that are not 
displayed on the screen; these locations are reserved for use by 
the peripherai cards (see Chapter 6). 

Display Page 2, the alternate text and low-resolution-graphics 
display buffer, occupies memory pages 8 through 1 1 (locations 
2048 through 3Q7i , hexadecimal $0BO0 through *obff). Most 
programs do not use Page 2 for displays, so they can use this 
area for program or data storage. 

The primary high-resoiution-graphlcs display buffer, called high- 
resolution Page 1 , occupies memory pages 32 through 63 
{locations 8192 through 16383, hexadecimal *£000 through 
*3FFF). If your program doesn't use high-resolution graphics, this 
area is usabJe for programs or data. 

High-resolution-graphics Page 2 occupies memory pages 64 
through 95 (locations 1G3B4 through 2457s. hexadecimal «4000 
through *5FFF). Most programs use this area for program or data 
storage 

For more information about the display buffers, see Chapter 2. 
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Table 4-1 Monitor Zero-page Usage 



High Nybble Low Nybble of AddrfiftS T^j 

Of Address to »1 *2 *3 «^ *S »6 *7 *8 *9 *A IB »C IB »E »F ^^^^l 

tlO * " I 

•30 ^ 

•50 J 

•AO ^^ 

IBO J 

•CO J 



Table 4-2 Applesoft Zero-page Usage 



High Nybble Low Nybble ol Address 

of Address *0 tl »? *3 «4 *S (6 17 «0 *9 »fl »B tc *!> *E *F 



• DO 

• 10 

t£a 

•30 

• 40 

• 50 

•BD 
»7D 
«BQ 
•90 
•AO 
•BO 
•CQ 
•DO 
•ED 
•FO 
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Table 4-3 Integer 8ASIC Zero=page 
Usage 



Table 4-4 DOS 33 ^ero-page Usage 



High Nybbl^ Low Nvbble of Address 

ofAddress io $1 I? t3 »4 tg tg 17 «e t3 tA *S IC iD «E tF 



COD 
*10 

*40 

• SO 



«G0 
*70 




teo 




*90 




*flO 




«B0 




tco 




tDO 




«e:d 




*F0 


• • 


High Nybble 
of Addresfi 


Low Nybble of Address 

«0 t1 t2 t3 94 IG $6 »7 *B «9 «A »B «C «D SE tr 


too 




SlO 




*20 




*30 




»40 





*50 

S8G 

tBO 
*C0 

too 

*F0 
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BBirk-switched Memory 

The memory address space from 52K to G^K (hexadecimal »dooo 
through *ffff) is doubly altacated: it is used for both ROM and 
RAM. The 12K bytes of ROM (read-only memory) in this address 
space contain the Monitor and the Applesoft BASIC interpreter. 
Alternatively, there are 16K bytes of RAM in (his space. The 
RAM is normally used for storing either the Integer BASIC 
interpreter or part of the Pascal Operating System (purchased 
separately). 

You may be wondering why this part of memory has such a split 
personality. Some of the reasons are hEStorical: the Apple Me is 
able to run software written tor the Apple II and Appfe II Plus 
because it uses this part of memory in the same way they do It 
is convenient to have the Applesoft fnlerpreter in ROM, but the 
Apple He, Ifke an Apple II with a language card, is also able to 
use that address space for other things when Applesoft is not 
needed. 

You may also be wondering how 16K bytes of RAM is mapped 
into only 12K bytes of address space. The usual answer is that 
it's done with mirrors, and that isn't a bad analogy: the 4K-byte 
address space from 52 < toSGK (hexadecimal *dooq through »dfff) 
is used twice. 

Switching different blocks of memory into the same address 
space is called bank switching. There are actually two examples 
of bank-switching going on here: first, the entire address space 
fromSPK toGiK {*DQOO through *ffff) is switched between ROM 
and RAM, and second, the address space from S2K to SSK (SDOOO 
to sdfff] is switched between two different blocks of RAM. 



Figure' 4*3 Bank-switched Memofy Map fFFF 
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^ Table 4-5 Bank Select Swilches 

0) This switch write-enables RAW! 
an<J read-erabtea ROM. 
(2) Two Successive reads to this 
switch enables RAM bolh for reading 
and writing. 



Setting Bank Switches 

You switch banks of memory \n Ihe same way you switch other 
functions in the Apple lie: by using soft switches. These soft 
switches do three things; select either RAM or ROM in this 
memory space; enable or inhibit writing to the RAM (write- 
protect), and select thie first or second 4K-byte bank of RAM in 
the address space *D0O0 to *DFFF. 

Warning 

Do noi use these switches wrthoul carefuJ planning. Careless 
switching between RAM and ROM is almost certain to have 
catastrophic effects on your programi. 

Table 4-5 shows the addresses of the soft switches for enabling 
all combinations of reading and writing in this memory space. All 
of the hexadecimal values of Ihe addresses are of the form *C08x. 
Notice that several addresses perform the same function: this is 
because the soft switches are activated by combinations of 
address bits. For example, any address of the fonn scGSx with a 
1 in the low-order bit enables the RAM for writing, Similariy, bit 3 
of the address selects which 4K block of RAM to use for the 
address space *Dooo-*dfff; if bit 3 is o, the first bank of RAM is 
used, and if bit 3 is 1 , the second bank is used. 



Switcli 


Write 


Read 


Read 


4K RAM Bank: 




Address 


RAM 


RAM 


ROM 


First Second 


Notea 


»C080 




• 








tCD81 










1 


«CQS2 












»coe3 










2 


*C08-t 












«cDes 










1 


SCD86 












SC087 










2 


«CDee 












SC089 










1 


SCOBf^ 












tCQ8B 










2 


ccoec 












SCQSD 










1 


JCQSE 












JCDSF 


B 


■ 
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When RAM is not enabled for reading, the ROM in this address 
space is enabled. Even when RAM is not enabled for reading, it 
can still be written to if it is write-enabled. 

When you turn power on or reset the Apple lie, it initializes the 
bank switches for reading the ROM and writing the RAM, using 
the second bank of RAM. Note that this is different from the 
reset on the Apple II Plus, which didn't affect the bank-switched 
memory (the language card). On the Apple lie. you can't use the 
reset vector to return controi to a program in bank-switched 
memory, as you couid on the Apple 1) Plus. 

When you are using Integer BASIC on the Apple lie, reset works 
correctly, restarting BASIC with your program intact. This happens 
because the reset vector iransrers control to DOS, and DOS resets 
the switches for the current version of BASIC. 

Note that you can't read ona RAM bank and wrtte to the other: if 
you select either HAM bank for reading, you get that one for writing 
as welL 

You can't read from ROM in part of the bank-switched memory and 
read from HAM in the rest: specifically, you can't read the Monitor in 
ROM while reading bank-switched RAM. II you want to use tha 
Monitor firmware with a program in bank-switched RAM, first copy 
the Monitor from ROM (locations treoo through «FFCS] into lower 
RAM and then into bank-swftched BAM. 

To see how to use these switches^ iook at the following section 
of an assembly-language program: 



flD 


63 


CO 


LDfi 


*C0B3 


\ SELECT 2ND 4K BANK 
READ/WRITE 


PD 


83 


CO 


LDA 


*C083 


i BY TWO CDNSECUTWE READS 


fl9 


DO 




LDA 


'(DO 


J SET UP. . .. 


95 


01 




STA 


BEGIN 


J ...NEW,.. 


ftS 


FF 




LDA 


#tFF 


; . . .MftlH-MEMORY, . . 


BE 


02 




STA 


END 


; . . .PQINTERS. . . 


20 


97 


C9 


JSR 


RAMTST 


; . . .FDR %ZK BANK 


AD 


SB 


CO 


LDA 


«C08B 


; SELECT 1ST 4K BANK 


£0 


97 


09 


JSR 


RflMTST 


; USE ABOVE POINTERS 


flD 


83 


CO 


LDfl 


tC088 


! SELECT 1ST BANK k 
WRITE PROTECT 



i 

J 
J 

3 

"J 
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ftfl 


RO 




LDfl 


#$G0 




£B 


10 




INC 


TSTNUM 




20 


58 


C9 


JS« 


WPTSINIT 




AD 


80 


CO 


LDfl 


ICOSO 


; SELECT END BANK 4 
WRITE PROTECT 


FR 


10 




IMC 


TSTHUM 




AS 


01 




LDA 


'PflTl2K 




£0 


56 


C3 


J5R 


WPTSINIT 




AD 


3Q 


CO 


LDA 


tCOSB 


i SELECT 1ST BANK A 
READ/WRITE 


flO 


RB 


CO 


LDA 


SCOGB 


I BY TWO CONSECUTIVE REA! 


Ffl 


flF 




INC 


RWMODE 


; FLAG RAM IN READ/WRITE 


Efi 


1 D 




INC 


TSTKUM 




AfJ 


CR 




LD(^ 


'PftT4K 




20 


5 a 


cs 


JSR 


WPTSINIT 





The LDA instruction, which performs a read operation to the 
specified memory location, is used for setting the soft switches. 
The unusual sequence of two consecutive LDA instructions 
performs tf^e two consecutive reads that write-enable this area of 
RAM; in this case, the data that are read are not used. 

Auxiliary Memory and Firmware 

By Installing an optional card in the auxiliary slot, you can add 
more memory to the Apple lie. One such card is the eO-cotumn 
text card, whtcfi has IK bytes of additional RAI^ for expanding 
the text display from 40 columns to 80 columns. 

Another optional card, the extended BO-column text card, has 
64K of additional RAM. A IK-byte area of this memory serves 
the same purpose as the memory on the SO-column text card: 
expanding the text display to 80 columns. The other 63K bytes 
can be used as auxiliary program and data storage. If you use 
only 40'Column displays, the entire 64K bytes is available for 
programs and data. 



Warning 

Do not attempt to use the auxiliary memory from a BASIC program. 
Th9 SASIC interpreter uses several areas in main RAM. including 
the stack and the zero page. If you switch to auxiliary memory in 
these areas, the BASIC interpreter fails and you must reset (he 
system and start over. 
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Figure 4-4 Memory map wilh Auxiliary 
Memory 
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As you can see by studying the mernory map in Figure 4-4, the 
auxiliary memory is broken into two large sections and one small 
one. The largest section is switched into the memory address 
spacefromSisto-ieiEi (*20 through «BFFF). This space includes 
the display buffer pages: as described in Chapter 2, space in 
auxiliary memory is used for one fialf of the 80-column text 
display. You can switch to the auxiliary memory for this entire 
rnemory space, or you can switch just the display pages: see the 
section "Memory Mode Switching"", below, 

If the only reason you are using auxiliary memory is for the BD- 
coiumn display, note that you can store into the display page in 
auxiliary memory by using the eosTOSfE and page^ soft switches 
described in the section "Display Mode Switching' in Chapter 2. 
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The other large section of auxiliary memory fs switched into the 
memory address space from saK to 6<1K (JDQOO through »ffff). 
This memory space and the switches that control it are described 
above in the section "Sank-s witched Memory \ If you use the 
auxiliary RAM in this space, the soft switches have (he same 
eflect on the auxiliary RAM That they do on the main RAM: the 
bank switching is independent of the auxiliary-RAM switching. 

Mote that the soft switches for the bank-switched memory, described 
in the previous section, do not change when you switch to auxiliary 
RAM. In particular, If ROM is enabled in the bank-switched memory 
space before you switch lo auxiliary memory, the ROM will still be 
enabled after you switch. Any time you switch the bank-switched 
section of auxiliary memory In and OLrt, you must also make sure 
that the bank switches are set properly. 

When you switch in the auxiliary RAf\^ in the bank-switched 
space, you also switch the first two pages, from Q to 5i i (»000 
through toi FF), This part of memory contains page zero, which is 
used for important data and base addresses, and page one. 
which is the 6502 stack. The stack and zero page are switched 
this way so that system software running in the bank-switched 
memory space can maintain its own stack and zero page while it 
manipulates the 48K address space (from *0200 to *BFFF) in either 
main memory or auxiliary memory. 

Memory Mode Switching 

Switching the 48K section of memory Is performed by two soft 
switches: the switch named RAMRD selects main or auxiliary 
memory for reading, and the one named RflMWRT selects main or 
auxiliary memory for writing. As shown in Table 4-6, each switch 
has a pair of memory locations dedicated to it, one to select 
main memory, and the other to select auxiliary memory. Enabling 
the read and write functions independently makes it possible tor 
a program whose instructions are being fetched from one 
memory space to store data into the other memory space. 

Warning 

Do not use these switches without careful planning. Careiess 
switching between main and auxiliary memories is almosl certain to 
have catastrophic effects on the operation of the Apple lie. For 
example, it you switch to auxiliary memory with no auxiliary memory 
card installed, the program thai is running will stop and you will 
have to reset the Apple lie and start over. 



Auxiliary Memory and Firmware 



73 



Writing to the soft-switch at location »C0 03 turns RAMRD on and 
enables auxiliary memory for reading; writing to location *C00 2 
turns RAMRD off and enables main memory for reading. Writing to 
tine soft-switch at location *C005 turns RAMWRT on and enables the 
auxiliary memory tor writing; writing to location tc004 turns RAWWRT 
off and enables main memory for writing. By setting these 
switches independently, you can use any of the four 
combinations of reading and writing in main or auxiliary memory. 

Auxiliary memory corresponding to text Page 1 and high- 
resotution graphics Page l can be used as part of the address 
space from »DPao to *bfff by using RAtiRD and RflMWRT as described 
above. These areas in auxiliary RAM can also be controlled 
separately by using the switches described in the section 
"Display Mode Switching" in Chapter 2. Those switches are 
named sosTQRE. pa&£2, and hires. 

As shown in Tabie 4-6, the 80 STORE switch functions as an 
enabling switch: with it on, the PflGE2 switch selects main memory 
or auxiliary memory. With the hires switch off, the memory space 
switched by PAG£2 is the text display Page 1. from *040 to*07FF; 
with H [RES on, PAGE2 switches both text Page 1 and high -resolution 
graphics Page 1, from »£0 0O to »3FFF. 

If you are using both the auxiliary-RAM control switches and the 
auxiliary-display-page control switches, the display-page controi 
switches take pnoriJy: If aoSTDR^ is off, RAMRD and RAMUIRT work for 
the entire memory space from *0£0D to *BFFF, but if 
eosTQRE is on. RAMRD and RAMWRT hav© no effect on the display 
page. SpeciticaHy, if eoSTORE is on and hi res is off, PA0E2 controls 
text Page 1 regardless of the settings of RAMRD and RAfnuiRT. 
Likewise, if 80 store and HIRES are both on, PflGE2 controls both text 
Page 1 and high-resolutton graphics Page 1 , again regardless of 
RAMRD and RAnWRT. 

A single soft switch named altzp (for alternate zero page) 
switches the bank-switched memory and the associated stack 
and ^ero page area between main and auxiliary memory. As 
shown in Table 4-6. writing to iocation «C0 03 turns ALT2P on and 
seiects auxiiiaFy-memory stack and zero page: writing to the soft 
switch at location *G008 turns ALTZP off and seiects main-memory 
stack and zero page for both reading and writing. The section 
■Auxiliary-memory Routines", below, describes firmware that you 
can call to help you switch between main and auxiliary memory. 
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When Ihese switches are on. atijcilrar^ 
memory is being used; when Ihey are 
off, main memory is being used- 



Table 4-6 Auxiliary-memary Select 
Switches 

[IJWhen eOSTDHEison, the Pf\Q^2 
switch selects main or auxiliary display 
memory. 

(2) When eOSTQRElBon, the HIHES 
switch enables you to jse the PftGta 
switch to switch between the 
high-resoljtron Page-1 area in main 
memory or auxJJiafy memofy- 



There are three more locations associated with the auxiliary- 
memory switches. The high-order bits of the bytes you read at 
these locations tell you the settings of the three soft switches 
descnbed above. The byte you read at location *coi 3 has its high 
bit set to 1 if ramrd is on (auxiliary memory is read-enabled}, or 
if RAMRD is off (the 48K block of main memory is read-enabled). 
The byte location «CQ1 ^ has its high bit set to 1 if Rf^nwRT is on 
(auxiliary memory is write-enabled), or if RflPIWRT is off (the 48K 
block of main memory is write-enabled). The byte at location 
*coiG has 6ts high bit set to 1 if f^LTZP is on (the bank-swilched 
area, stack, and zero page in the auxiliary memory are selected), 
or if ftLTZP is off (these areas in main memory are selected). 



Name 


Function 


Location 
Hex Uecim^l 


Notes 


RAMRD 


Read auxiliary memory 
Read .main memory 
Read Rf^PlRDswitCh 


«C003 
*C013 


^9195 
49154 
49171 


- 16381 

-163B2 

1G3G5 


Wrte 
Write 

Read 


RAMURT 


Write auxiliary memory 
Write mam memory 
Read RAMWRT switch 


»CO05 
*C004 
»C0t4 


49157 
49156 
49172 


- 16379 

-16380 
-163S4 


Write 
Write 
Read 


eO STORE 


On: access display page 
Off: use RAMRD, RAMWRT 
Read 80 5Ti:iftE: switch 


tC001 
ICOOO 
«C018 


491S3 
49152 
491 7e 


- 16383 
163S4 

-iG3eo 


Write 
Write 
Read 


PAGE2 


Page 2 on (Aujc. memory) 
Page 2 oil (Main memory) 
Read PftGEa switch 


• C055 
«C054 

•coic 


49237 
4923G 
49180 


-16299 
-16300 
-163S6 


1 
1 
Read 


HIRES 


On- access hi-res pages 
Olf;use RftMRD, RAMWfiT 

Read HI RES switch 


*C057 
tC056 
JCOID 


492 39 
49^38 
49181 


1G^97 

ia298 

- I63S5 


2 
2 
Read 


ALTZP 


AuKiiiary stack &, z. p. 
Main stack a zero page 
Read ALTZP switch 


*C009 
IC008 

1C01G 


49161 
49teD 
49174 


16373 
-!6374 
- 16352 


Write 
Write 

Read 
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Table 4-7 Auxiliary-memorv Roulines 



In order to have enough mernofy locations for all of the soft 
switches and remain compatible with the Apple II and Apple 11 Plus, 
me soft switches listed rn TabSe 4-6 share their memory locations 
with the Keyboard functions listed in Table 2-2- The operations — 
read or write — shown in Table 4-6 for controlling the auxiliary 
memory are just the ones that are not used for reading the 
keyboard and clearing the strobe. 



Auxitiary-memory Subroutines 

M you want to write assembly-language programs that use 
auxiliary memory but you don't want to manage the auxiliary 
memory yourself, you can use the built-in auxiliary-memory 
subroutines These subroutines make it possible to use the 
auxiliary memory without having to manipulate the soft switches 
described in the previous section. 

The subroutines described below make it easier to use auxiliary 
memory, but they do not protect you from errors. You still have to 
pian your use of auxiliary memory to avoid catastrophic effects on 
your program. 

You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3; by making subroutine calls to 
their starting locations. Those locations are shown in Table 4-7. 



i 



fc-j 



Subroutine Location Descriplion 
Ma me 



ftUXnOVE 'cai 1 Moves data blocks between main and awiliary memory 

XFER *C314 Tfansters program control between main and auxiliary 

memciry 
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Table 4-e Parameters for AUXMQVE 

Routine 



Moving Data io Auxliiary Memory 

Jn your assembly-fanguage programs, you can use the built-in 
subroutine named AUXMDVE to copy blocks of data from main 
memory to auxiliary memory or from auxiliary memory to main 
memory. Before calling this routine, you must put the data 
addresses into byte pairs in page zero and set the carry bit to 
select the direction of the move — main to auxiliary or auxiliary 
to main. 

Warning 

Don't try to use fluxMDVE to copy data in page ^ero or page one (the 
6502 stack) or m the bank-switched memory (iDOQO-tFFFF). Auxnovt: 
uses page ?ero all during the copy, so it can't handle moves in the 
memory space switched by ALTzP. 

The pairs of bytes you use for passing addresses to this 
subroutine are called Ai , A2, and A^, and they are used for 
parameter passing by several of the Apple lie's built-in routines. 
The addresses of these byte patrs are shown in Table 4-8. 



Name Locatkon Parameter pasfied 



Carry 



AIL 


*3C 


AIH 


«3I> 


A2L 


• 3E 


A2H 


I3F 


ML 


f42 


A4H 


«43 



1 = Move from main lo auxiliary meiriory 
= Move from auxiliary to main memory 

Source starting address, low-order byle 
Source starting address, hi<yh-Drdef byle 

Source ending address, iow-order byte 
Source ending address, high-ofder byte 

Destination starting address, low-order byte 
Destination starting address, high-order byte 
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Table 4-9 Paramelensfor XFER 
Routine 



Put the addresses of the first and last bytes of the block of 
memory you want to copy into A1 and A2, Put the starting 
address of the block of memory you want to copy the data to 
into A4. 

The AUKMOVE routine uses the carry bit to select the dErection to 
copy the data. To copy data from main mernory to auxiliary 
memory, set the carry bit; to copy data from auxiliary memory to 
main memory, dear the carry bit. 

When you make the subroutine call to aukmdve. the subroutine 
copies the block of data as specified by the A registers and the 
carry bit. When it is finished, the accumulator and the X and Y 

registers are just as they were when you called it. 

Transferring Control to AuxiliarY Memory 

You can use the built-in routine named XFER to transfer control to 
and from program segn^ents in auxiliary memory. You must set 
up three parameters before using xfeR: the address of the routine 
you are Jransfernng to^ the direction of the transfer <main to 
auxiliary or auxiliary to main), and which page zero and stack 
you want to use. 



Name or 



Parameter passed 



Carry 



Overflow 



»3ED 
t3EE 



1 = Transfer from main to auxiliary memory 

- Transfer from auxiliary lo main memory 

1 = Use page l^to and stack in auJiiliary memory 
= Use page zero and stack in mam memcuv 

Program starting address, low-order byte 
Program staiting actdress, high-order byte 



Put the transfer address into the two bytes at (ocations *3ED and 
«3EE . with the low-order byte first, as usual. The direction of the 
transfer is controlled by the can^ bit: set the carry bit to transfer 
to a program in auxiliary memory; clear the carry bit to transfer lo 
a program in main memory. Use the overflow bit to select which 
page zero and stack you want to use; clear the overtlow bit to 
use the main memory; set the overflow bit to use the auxiliary 
memory. 
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After you have set up the parameters, pass control to the xfer 
routine by a jump instruction, rather than a subroutine calL XFER 
saves the accumulator and the transfer address on the current 
stack, then sets up the soft switches for the parameters you have 
selected and jumps to the new program. 



Warning 

II is ihe programrrier's responsibility to save the current stack pointer 
somewhere in Ihe current mGmory space before using kfer and to 
restore i! after regaining control. Failure to do so will cause prografn 
errors. 



The Reset Routine 

To put the Apple He into a known state when tt has just been 
turned on or after a program has malfunctioned, there is a 
procedure called the reset routine. The reset routine is built into 
the Apple lie's firmware, and it is initiated any time you turn 
power on or press the [ RESET J key while holding down the 
I CONTROL ] key. The reset routine puts the Apple Me into its normal 
operating mode and restarts the resident program. 

When you initiate a reset, hardware in the Apple lie sets the 
memory-controlling soft switches to normal: main board RAM and 
ROM are enabled, and, if there is an 80-column text or extended 
80-column text card in the auxiliary slot, expansion slot 3 is 
allocated to the built-in eo-column firmware. Auxiliary RAM is 
disabled and the bank-switched memory space is set up to read 
from ROM and whte to RAM, using the second bank at *D0 0O. 

The reset routine sets the display-controlling soft switches to 
display 40-cofumn text Page 1 using the primary character set, 
then sets the window equal to the full 40-column display, puts 
the cursor at the bottom of the screen and sets the display 
format to normal. 

The reset routine sets the keyboard and display as the standard 
input and output devices by loading the standard I/O links (see 
Chapter 6), It turns annunciators and 1 off and annunciators 2 
and 3 on, clears the keyboard strobe, turns off any active 
accessory-card ROM (see Chapter 6) and outputs a bell (tone). 

The Apple lie has three types of reset: power-on reset, also 
called cold-start reset; warm-start reset; and forced cold-start 
reset. The procedure described above is the same for any type 
of reset. What happens next depends on the reset vector. The 
reset routine checks the reset vector to determine whether it is 
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valid or not, as described below in tlie section, The Reset 
Vector". If the reset was caused by turning the power on, the 
vector will not be valid, and the reset routine will perform the 
cold-start procedure. It the vector is vaild, the routine will perform 
the warm-start procedure. 



The Cold-start Procedure 



If the reset vector is not valid, either the Apple lie has just been 
turned on or something has caused memory contents to be 
changed. The reset routine ciears the display and puts the string 
"Apple |[" at the top of the display. It ioads the reset vector and 
the validity-check byte as described below, then starts checking 
the expansion slots to see if there is a disk drive controller card 
in one of them, starting with slot 7 and working down. If it finds a 
controller card, it initiates the bootstrap (startup) routine that 
resides in the controller card^s firmware. The bootstrap then loads 
the Disk Operating System from the disk in drive 1 . When DOS 
has been loaded, It displays other messages on the screen. If 
fhere is no disk in the disk drjve, th e driv e mo tor just keeps 
spinning until you press rcDMT RDL | - \ RESET | . For more information 
about DOS and the startup procedure, see the DOS Manuai. 

If the reset routine doesn't find a controller card, or if you press 
I CONTROlI -j RESET [again before the startup procedure has been 
completed, the reset routine will continue without using the disk, 
and pass control to the buiSt-in Applesoft interpreter. 



The Warm-start Procedure 



Whenever you press f CONTROL ] - j~ftESET |when the Apple lie has 
already completed a cold-start reset, the reset vector is still valid 
and it is not necessary to reinitialize the entire system. The reset 
routine simply uses the vector to transfer control to the resident 
program, which is normally the built-in Applesoft interpreter. It the 
resident program is indeed Applesoft, your Applesoft program 
and variables are still intact. If you are using DOS, it is the 
resident program and it restarts either Applesoft or Integer^ 
BA SIC, w hichever you were using when you pressed [CDNTRoT]- 
Preset 1. 
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A program in bank-switched RAM cannot use the resel vector to 
regain control after a reset, because the reset routine enables ROM 
in the bank-switched memory space. If you are using Integer 
BASIC, which is in the bank-switched RAM, you are also using 
DOS, and it Is DOS that controls the reset vector and restarts 
BASIC. 
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forced Coid Start 

If a program has loaded the reset vector to point to the beginning 
of the program, as described below, pressing [ caNTRDL~| -|_RESET^ 
causes a warm-start reset that uses the vector to transfer control 
to that program. If you want to stop such a program without 
turning the power off a nd on, you can force a cold-start reset by 
holding down the I COm trq l] key and the [ DPEH-APPLE | key, then 
pressing and releasing the reset J key. 

When yay want \o stop a program uncorrditlonally — for example, to 
start up the Apple Me with some othe r program — you should use 
the forced cold'Starl reset, [ cqhTrdl | - |OPEN-ftpPLE] -[j€sET]. instead ot 
turning the power oft and on. 



Wheneveryou press | control | -! RE SEQ fir mware in the Apple He 
always checks to see whether either ! flPPLE | key is down. If the 
fsOL ID- APPL E J key Is down , with or withQutthe [ DPEM-flPPLE | key, 
the firmware p erforms the self-test described below, if only the 
I OPEN-APPLE ] key is down, (he firmware starts a forced cold-start 
reset. First, it destroys the program or data in memory by writing 
two bytes of arbitrary data into each page of main RAM. The two 
bytes that get written o\/er in page 3 are the ones that contain 
the reset vector. The reset routine then performs a normal cold- 
start reset. 



The ResBt Vector 

When you reset the Apple lie, the reset routine transfers control 
to the resident program by means of an address stored in 
page 3 of main RAfvl. This address is called a vector because it 
directs program control to a specified destination. There are 
several other vector addresses stored in page 3, as shown in 
Table 4-10. including the interrupt vectors described in Chapter 6, 
and the DOS vectors described In the DOS Manual. 

The cold-start reset routine stores the starting address of the 
built-in Applesoft Interpreter, low order byte fjrst. in the reset 
vector address at locations i oi o and i Cii (hexadecimal *3F2 and 
*3F3). It then stores a validity check byte, also called the power- 
up byte, at location i Oi £ (hexadecimal *3F4). The validity-check 
byte Is computed by performing an excluawe-DR of the second 
byte of the vector with the constant 165 (hexadecimal $A5). Each 
time you reset the Apple Me, the reset routine uses this byte to 
determine whether the reset vector is still valid. 
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You can change the reset vector so that the reset routine will 
transfer control to your program instead of to the Applesoft 
interpreter For this to work, you must also change the validity- 
check byte to the enciuaive-DR of the high-order byte of your new 
reset vector with the constant 165 ($A5). If you fail to do this, 
then the next time you reset the Apple lie, the reset routine will 
determine that the reset vector is invalid and perform a cold-start 
reset, eventually transferring control to the disk bootstrap routine 
or to Applesoft. 






Table 4-10 Page 3 Vectors 



Vector addre&s 
DeclmaL Hex 



1G08 
1QD9 



Vector function 



t3F Address ol the subroufine that hardies BRK requesls 

*3F1 {normally »59. *Ffi). 



1 1 t3F2 Reset veclor (see texl). 



101£ 



S3F4 



Power-up byie (see text). 



1Q13 
1014 

1015 



*3F5 
*3FG 

*3F7 



Jump Instruction to the subrDuHne thai handles Applesoft 

'■&'■ commahOs (mrmally »4C, *S9- *FF1- 



1 01G 

1 Q17 



t3re 

*3F5 

*3Ffl 



Jump instruction to the subroutine that handles user 

(I CnHTRPL ]-V) commands, 



1019 
1DE0 
1021 



t3FB 
t3FC 
*3FD 



Jump instruclion 1o the subroutine Ihat handles 
n on- m askable interrupts. 



1 022 »3FE Interrupt vector (address of the subrojline that handles 

1 0Z3 'SFF interrupt requests}. 
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The reset routine has a subroutine that generates the vafidity- 
check byte for the current reset vector. You can use this 
subroutine by doing a subroutine call to location -i 169 
(hexadecimal *fb6F). When your program finishes, it can return 
the Apple Me to normal operation by restoring the original reset 
vector and again calling the subroutine to fix up the validfty-check 
byte. 

Automatic Self-test 



Ef yo u reset the A pple lie by holding down the I control | key and 
the |_SDLi^- APPLeJ key while pressing and releasing the RESE T ] 
key, the reset routine will start running the built-in self-test. 
Successfully running this test assures you that the Apple lie is 
operational. 



Warning 

The self-tesi routine tests the Apple lie's prtsgramnnable memory by 
writing and then reading it. All programs and data iri programmable 
memory when you run the self-test are destroyed. 

The selMest takes several seconds to run. While W is running, 
the display changes from black to white and bach twice. If the 
test finishes normally, the Apple He displays an "OK" message 
and waits tor you to request a normal reset. 

It the self-test detects something wrong, it displays an error 
message and stops. If you have been running programs prior to 
running the self-test, some soft-switches could be on, causing the 
self-test to fail and display an error message. If this happens, 
turn the power off for several seconds^ then turn it back on and 
run the self-test again If it still fails, there is really something 
wrong; to get it corrected, contact your Apple dealer for service. 
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Using The Monitor 



The System Monitor is a set of subroutines in the Apple lie 
firmware. The Monitor provides a standard interface to the built-in 
I/O devices described in Cfiapter 2. The I/O subroutines 
described in Chapter 3 are part of the System Monitor. 

The Disk Operating System and the BASIC interpreters use 
these subroutines by direct calls to their starting locations, as 
described for the I/O subroutines in Chapter 3; the starting 
addresses for all of the standard sttbrouttnes are listed in 
Appendix C, If you wish, you can call the standard subroutines 
from your programs in the same fashion. 

You can perform most of the Monitor functions directly from the 
keyboard. This chapter telis you how to use the Monitor to 

• look at one or more memory locations 

• change the contents of any location 

• write programs in machine language to be executed directly 
by the Apple lie's microprocessor 

• save blocks of data and programs onto cassette tape and 
read them back in again 

• move and compare blocks of memory 

• invoke other programs from the Monitor 

Invoking the Monitor 

The System Monitor starts at memory location «ff69 {decimal 
6538B or - 1 5 1 ). To invoke the Monitor, you make a call statement 
to this location from the keyboard or from a BASIC program. 
When the Monitor is running, its prompting character, an asterisk 
(• ), appears on the left side of the display screen, followed by a 
blinking cursor. 
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To use the Monitor, you type commands at the keyboard. When 
you have finished using the Monitor, you return t o the BASIC 

language you were previously u sing by pressing [ CDNTRDl1 ~ 
I RESEf I , by typing [ CONTROL | -C and pressing [R ETURN , , or 
by typing 3D0G, which executes the resident program — usually 
Applesoft — whose address is stored in a jump instruction at 
location *3D0. 

Syntax of Monitor Commands 

To give a command to t he Mon itor, you type a line on the 
keyboard, then press j JgETURN | . The Monitor accepts the line using 
the standard I/O subroutine GETLN described in Chapters, A 
Monitor command can be up to 255 characters in length, ending 
with a carriage return. 

A Monitor command can include three kinds of information: 
addresses, data values^ and command characters. You type 
addresses and data values in hexadecimal notation. Hexadecimal 
notation uses the ten decimal digits (0-9) and the first six letters 
(A-F) to represents the sixteen values from to 15. A pair of 
hexadecimal digits represents values from to 255, corresponding 
to a byte, and a group of four hexadecimal digits can represent 
values from lo 65.536, corresponding to a word. Any address 
in the Apple lie can be represented by four hexadecimal digits. 

When the command you type calls for an address, the Monitor 
accepts any group of hexadecimal digits. If there are fewer ihan 
four digits in the group, it adds leading zeros; if there are more 
than Jour hexadecimal digits, the Monitor uses only the last four 
digits. It follows a similar procedure when the command syntax 
calls for two digit data values. 

Each command you type consists of one command character. 
usually the first letter of the command name. The Monitor 
recognizes 22 different command characters. Some of them are 
punctuation marks, some are uppercase letters, and some are 
control characters. Note: although the Monitor recognizes and 
interprets them, control characters typed on an Input line do not 
appear on the screen. (See the Summary of Monitor 
Commands' at the end of the chapter.) 

This chapter contains many examples of the use of Monitor 
commands. In the examples, the commands and values you type 
are shown In a normal typeface and the responses of the Monitor 
are in a computer typeface. Of course, when you perform the 
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examples, all of the characters that appear on the display screen 
will be in the same typeface. Some of the data values displayed 
by your Apple Me may differ from (he values printed in these 
examples, because they are variables stored in programmable 
memory. 

Monitor Memory Commands 

When you use the Monitor to examine and change the contents 
of memory, it keeps track of the address of the last location 
whose value you inquired about and the address of fhe location 
that is next to have its value changed. These are called the last 
opened tocation and the next changeable location. 

Exam'mmg Memory Contents 

When you type the address of a memory location and press 
I RETURN \ the Monitor responds wilh the address you typed, a 
dash» a space, and the value stored at that location, like this: 



•EOOO 
EOOO- 20 
•33 



0033-AA 

■» 



Each time the Monitor displays the value stored at a location, it 
saves the address of that location as the fast opened location 
and as the next changeable focation. 



Memory Dump 

When you type a period 



followed by an address, and then 



press I RETURN , the Monitor displays a memory dump: the data 
values stored at all the memory locations from the one following 
the fast opened locatfon to the location whose address you typed 
following the period. The Monitor saves the Jast iocation 
dispJayed as both the last opened location and the ne;ct 
changeable location. In these examples, the amount of data 
displayed by the Monitor depends on how much larger than the 
last opened location the address after the period is. 
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• 20 



ooao- OD 



►.2B 



0021- 
0028- 


28 DO 1G OF DC OD 00 
A8 OG DO 07 


*300 


0300- 


99 






•.315 



0301- B9 00 08 Ofl OA OA 99 
0308- 00 09 C8 DO F4 A6 2B fi9 
0310- 09 85 Z7 AD CC 03 



.32A 



031G- 


SB 


41 














Q3te- 


84 


40 


8A 


4A 


4A 


4A 


4A 


09 


0320- 


CO 


8E 


3F 


A9 


SD 


85 


3E 


20 


0328- 

* 


43 


03 


20 













e2 



A memory dump includes several different items of information. 
The first line in the dump begins with the address of the location 
following the last opened location; all other lines begin with 
addresses that end alternately in zeros and eights, and there are 
never more than eighl data values displayed on a single line in a 
memory dump. 

When the Monitor performs a memory dump, it starts at the 
location immediately following the last opened location and 
displays that address and the data value stored there. It then 
displays the values of successive locations up to and including 
the location whose address you typed, but only up to eight 
values on a line. When it reaches a location whose address is a 
multiple of eight — that is, one that ends with an B or a — it 
displays that address as the beginning of a new line, then 
continues displaying more values. 
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After the Monitor has displayed the value at Ihe location whose 
address you specified in the command, it stops the memory 
dump and sets that location as both the last opened location and 
the next changeable location. If the address specified on the 
input line is less than the address of the last opene^i location, tf^e 
Monitor displays only the address and value of the location 
following the last opened location. 

You can combine the two commands, opening a location and 
dumping memory, by simply concatenating them: type the first 
address, a period, and the second address. This combination of 
two addresses separated by a period is called a memory range. 

•300.32F 




* 30.40 



0030- 


Afl 


00 


FF 


AA 


0^ 


C? 


05 


C2 


0038- 


1B 


FD 


DO 


03 


3C 


00 


40 


QO 


0040- 


3D 

















E015.E025 



£01S- 


4C ED FD 


E018- 


A9 20 C5 24 BO OC A3 SD 


E020- 


AO 07 £0 ED FD A9 


* 





Pressing the [ return J key by itself causes the Monitor to display 
one line of a memory dump: that is, a memory dump from the 
location foliowing (he last opened location to the next muitiple-of- 
eight boundary. The Monitor saves the address of the last 
location displayed as the last opened location and the next 
changeable location. 
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I 



#5 


O0O5- 00 


•1 RETURN 1 


OG 00 


*[ RETURN 1 



oooe- 


00 DO 


00 


00 


00 


00 


00 


00 


#32 


0032- 


FF 






























• 1 RETURN 1 




AA 00 


C2 05 


C2 




























*1 RETURN 1 




0336- 

m 


IB FD 


DO 


03 


3C 


00 


3F 


00 



















Changing Memory Contents 

The previous section showed you how to display the values 
stored in the Apple lie's memory; this section shows you how to 
change those values. You can change any location in 
RAM (programmable memory) and you can also change the soft 
switches and output devices by changing the locations assigned 
to them. 



Warning 

Use these commands carefully. If you change the zero-page 
locations used by Applesoft and DOS, you may lose programs or 
data stored In memory. 
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Changing One Byte 

The previous commands keep track of the nex^t changeable 
location; these commands make use of it. In the next example, 
you open focalion 0, then type a colon followed by a value. 

•0 

0000- 00 
•:5F 

The contents of the next changeable location have just been 
changed to the value you typed, as you can see by examining 
that location: 

•0 
0000- 5F 



You can also combine opening and changing into one operation 
by typing an address followed by a colon and a value. In the 

example, you type the address again to verify the change. 



•302:42 
•302 
0302- 42 



When you change the contents of a location, the value that was 
contained in that location disappears, never to be seen again. 
The new value will remain until you replace it with another vaiue. 

Changing Consecutive Locations 

You don't have to type a separate command with an address, 
a colon, a value, and \ return | for each location you want to 
change. You can change the the values of up to eighty-five 
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consecutive locations at a time (or even more, if you omit leading 
zeros from the values) by typing only the initial address and 
colon followed by all the values separated by spaces, and ending 
with I RETU RhTl . The IVIonitor wilt duly store the consecutive values 
in consecutive locations, starting at the location whose address 
you typed. After it has processed the string of \^alues, it takes the 
location following the last changed location as the next change- 
able location. Thus, you can continue changing consecutive 
locations without typing an address on the next input line by 
typing another colon and more values. In these examples, you 
first change some locations, then examine them to verify the 
changes, 

* 300:69 01 20 ED FD 4C 3 

•300 

0300- 69 



*l RETURN 



01 2a ED FD 4C QO 03 

•10:0 1 2 3 

•:4 5 6 7 

#10.17 

DOtO- 00 01 02 03 04 05 06 07 
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Moving Data in Memory 

You can copy a bbck of data stored in a range of memory 
locations from one area in memory to another by using the 
Monitor's MOVE command. To move a range of memory, you must 
tell the f^4onitor both where the data is now situated in memory 
— the source locations — and where you want the copy to go — 
the destination locations. You give this information to the Monitor 
by means of three addresses: the address of the first location in 
the destination and the addresses of the first and last locations in 
the source. You specify the starting and ending addresses of the 
source range by separating Ihem with a period. You separate the 
destination address from the range addresses with a iess-than 
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character {<), which you may think of as an arrow pointing in the 
direction ol the move. Finally, you tell the Monitor that this is a 
MOVE command by typing the letter ti. The format of the complete 
MOVE command looks like this; 

{destmaliony < {start} . {end} M 

When you type the actual command, the words in curly braces 
should be replaced by hexadecimal addresses, and the braces 
and spaces should be omitted. Here are some examples of 
memory moves. First, you examine the values stored in one 
range of memory^ then store several vafues in another range of 
memory; the actual MOVE commands end with the letter M: 



► O.F 



0000- sr 00 OS o? oo oo oo oo 

OOOS- 00 00 00 00 00 00 00 00 



^30O:A9 BD 20 ED FD A9 45 20 DA FD 4C 00 03 
'300.30C 



3300- A9 8D £0 ED FD A9 45 20 
1308" DA FD 4C 00 03 



'0<300.30CM 

'O.C 



0000" P9 8D 30 ED FD P9 45 30 
0008- DA FD 4C 00 03 



-310 8.AM 

•310.312 

0310- DA FD 4C 

«o.c 



0000- A9 8D £0 DA FD 
OOOB- DA FD 4C 00 03 



45 £1 
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The Monitor moves a copy of the data stored in the source range 
of locations to the destination locations. The values in the source 
range are left undisturbed. The Monitor remembers the last 
location in the source range as the last opened iocation, and the 
first location in the source range as the next changeable location. 
If the second address in the source range specification is less 
than the first, then only one value {that of the first location in the 
range) will be moved. 

If the destination address of frie MOVE command is inside the 
source range of addresses, then strange (and sometimes 
wonderful) things happen: the locations between the beginning of 
the source range and the destination address are treated as a 
sub-range and the values in this sub-range are repiicated 
throughout the source range. See the section 'Special Tricks with 
the Monitor" for an interesting application of this feature. 

Comparing Data in Memory 

You can use the ^/erifv command to compare two ranges of 
memory using the same format you use to move a range of 
memory from one piace to another. In fact, the VER I FV command 
can be used immediately after a move to make sure that the move 
was successful. The verify command, like the 1^0 VE command, 
needs a range and a destination. The syntax of the VER l rv 
command is: 

{destination} < {start} . {end} v 

The Monitor compares the values in the source locations with the 
values in the locations beginning at the destination address. If 
any values don't match, the Monitor displays the address at 
which the discrepancy was found and the two values that differ. 
In the example, you store data values in the range of locations 
from to *D. copy them to locations starting at *300 with the l^avE 
command, and then compare them using the ver I FY command. 
When you use the vesifv command after you change the value 
at location G to »E4, it detects the change. 



t 

J 
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u 

'A 
'J 



-0:D7 F2 E9 F4 F4 E5 EE AO E2 F9 AO C3 C4 C5 

•30O<0.DM 

*300<O.DV 

• 6:E4 

•300<O.DV 

0006-E4 ittr 



W the VER I FV command finds a discrepancy, it displays the 
address of (he locaiion in tfie source range whose value differs 
from its counterpart in the destination range. If there is no 
discrepancy, VERIFV displays nothing. The VERIFY command 
leaves tfie values in both ranges unchanged. The last opened 
location is the last location in the source range, and the next 
changeable location is the first location in the source range, just 
as in the MDVE command. If the ending address of the range is 
less than the starting address, the values of only the first 
locations h the ranges will be compared. Like the nOVE command, 
the VER I FY command atso does unusual things If the destination 
address Is within the source range; see the section "Special 
Tricks with the Monitor'". 

Monitor Register Command 

Even though the actual contents of the 6502s internal registers 
are changing as you use the Monitor, you can examine the 
values that the registers contained at the lime the Monitor gained 
contfo], either because you called it or because the program you 
are debugging stopped at a break (BRK). You can also store 
new register values that will be used when you execute a 
program from the Monitor using the GO command, described 
below. 

Examining and Changing Registers 

When you call the Monitor, it stores the contents of the B502 
registers in memory. The registers are stored in the order A, X, 
Y, P (processor status register), and S stack pointer), starting at 
location *'t5 (decimal 69). When you give the Monitor a GQ 
command, the Monitor loads the registers from these five 
locations before it executes the first instruction in your program. 
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Typing fcO NTRaL | -£ and pressing |_RETURN] invokes the Monitor's 
EXAMINE command, which displays the stored register values and 
sets the location containing the contents of the A-register as the 
next changeable location. After using the Examine command, you 
can change the values in these locations by typing a coion and 
then typing the new values separated by spaces. In the following 
example, you display the registers, change the first two. and then 
display them again to verify the change. 



' [CDNTRDL l -E 

A-OA X=FF Y-D8 P=^BO S-FB 

•:B0 C2 

■ RljNTRQL ] -E 

A=EO X"02 Y=0S P-BO S*FB 



J 

!j 

!j 

u 
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Monitor Cassette Tape Commands 

The Apple Ite has two jacks for connecting an audio cassette 
tape recorder, With a recorder connected, you can use the 
Monitor commands described below to save the contents of a 
range of memory onto a standard cassette and recali it again for 
iater use. 



Saving Data on Tape 

The Monitor's wr [TE command saves the contents of up to 65,536 
memory locations on cassette tape. To save a range of memory 
on tape, give the Monitor the starting and ending addresses of 
the range, followed by the letter w (for write), like this: 

{start} . {end} w 

Don't press lRETURk] yet: first, put the tape record er in re cord 
mode and let the tape run for a second, then press [^E_TIJ^RN_1 . The 
Monitor will write a ten-second tone onto the tape and then write 
the data The tone acts as a leader: later, when the Monitor 
reads the tape, the leader enables the Monitor to get in step with 
tho signal from the tape. When the Monitor is finished writing the 
range you specified, it wil' sound a bell (beep) and display a 
prompt. You should rewind the tape and label it with the memory 
range that's on the tape and what it's supposed to be. 



Using the Monitor 






Here s a small example you can save and use later to tiy out the 
READ command. Remember that you must start the cassette 
recorder in record mode before you press | return] after typing 
ttie WRITE command. 



tO.FF FF AD 30 CO 88 DO 04 C6 01 FO 08 CA 
DO F6 A6 00 4C 02 00 60 



•0.14 




•0.14W 



It takes about 35 seconds total to save the values of 4,096 
memory locations preceded by the ten-second leader onto tape. 
This works out to an average data transfer rate ot about 1,350 
bits per second. 

The UR ITE command writes one extra value on the tape after it 
has written the values In the mernory range. This extra vaiue is 
the checksum, which is the eight-bit partial sum of all values in 
the range. When the Monitor reads the tape, it uses this value to 
determine if the data has been written and read correctly (see 
below). 

Reading Data from Tape 

Once you've saved a memory range onto tape with the Monitor's 
WRITE command, you can read that memory range back into the 
computer by using the Monitor's REftD command. The data values 
you ve stored on the tape need not be read back into the same 
memory range from whence they came; you can teil the Monitor 
to put those values into any memory range in the computer's 
memory, provided that it's the same size as the range you 
saved. The format of the READ command is the same as that of 
the WRITE command, except that the command letter is R: 

{start} . {end} R 
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Once again, after typing the command, don't press | RETURN] 



Instead, start the tape recorder in play mode and wait a few 
seconds. Although the WHITE command puts a ten-second leader 
tone on the beginning of the tape, the RtflD command needs only 
three seconds of this leader to lock on to the signal from the 
tape. You shouid let a few seconds of tape go by before you 
press |_R ETURMn to allow the tape recorders output to settle down 
to a steady tone. 

This example has two parts. First, you set a range of memory to 
zero, verily the contents of memory and then type the READ 
command, but don't press | return] . 



!j 



• 0:0 OOOOOOOOOOOOOOOOOOOO 

• 0.14 



aooo- 


DO 


00 


00 


00 


00 


00 


00 


00 


oooe- 


00 


00 


00 


00 


DO 


00 


00 


00 


0O10- 


00 


00 


00 


oo 


00 









■0.14R 

Now start I he casset te running in play mode, wait a few seconds, 
and press | RETURN ] . After the Monitor sounds the hell (beep) and 
displays the prompt, eicamine the range of memory to see that 
the values from the tape w^re read correctly: 



i0.14 



OOOQ- 


FF 


FF 


AD 


30 


CO 


68 


DO 


04 


ooae- 


C6 


01 


FO 


08 


CA 


DO 


F6 


AG 


OOlQ- 

* 


00 


4C 


D2 


QO 


60 









After the Monitor has read all the data \/alues on the tape, it 
reads the checksum value It computes the checksum on the 
data it read and compares it to the checksum from the tape. If 
the two checksums differ, the Monitor sends a beep to the 
speaker and displays "ERR". This warns you that there was a 
problem reading the tape and that the vatues stored in memory 
aren't the values that were recorded on the tape. If the two 
checksums match, the Monitor will just send out a beep and 
display a prompt. 
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Miscellaneous Monitor Commands 

These Monitor commands enable you to change the video 
display format from normal to inverse and back, and to assign 
input and output to peripherals in expansion slots 

Dfsptay inverse and Normal 

You can control the setting of the inverse-normal mask location 
used by the CDUT subroutine (described in Chapters) from the 
Monitor so that all of the Monitor's output wili be in inverse 
format. The INVERSE command, I, sets the mask such that all 
subsequent inputs and outputs are displayed in inverse format 
To switch the (Monitor's output back to normal format, use the 
NORMi^L command, H. 



•O-F 



0000- OA OB OC OD OE OF DO 04 
0008- C6 01 FO 08 CA DO F6 AS 



*i 



•ap 



0000- OA 05 OC DD OE OF DO 04 
0008- C6 Ot FO 08 CA DO F6 A6 



'O.F 



0000- 
0008- 


Ofl OB OC OD OE OF DO 04 
C6 01 FO 06 CA DD F8 A6 


♦ 
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K--^ 



Back to BASIC 



Usethe BASIC command. [caHTROL J -B , to leave the Monitor and 1^ 
enter the BASIC thiat was active when you entered thie Monitor. 
NonDally, this is Applesoft BASIC, unless you deliberately 
switched to Integer BASIC. Any program or variables that you 
had previously in BASIC will be lost. If you want to re-enter 
BASIC with your previous program and variables intact, use the 
CONTINUE BASlCcommand, fcD NTRaL~| -c . If you ar e using th e 
Apple Disk Operating System (DOS), pressrcaNTRQLj - 1 RESET | or 
type 



3D0G 

to return to the language you were using, with your program and 
variables intact. 

II you type the latter command, make sure that the third character 
you type is a. zero, not a letter O, The letter G is the Monitor's gD 
command, de&cribed below in the section "Machine-language 
Programs". 



u 
u 

1^ 



iLri 



RedirBCting fnpui and Output 

The PR INTER command, aclivated by a [cnNTRaL] -P , diverts all 
output normally destined for the screen to an interface card in a 
specified exapnsion slot, from 1 to 7. There must be an interface 
card in the specified slot, or you will lose control ot the computer 
and your program and variables may be lost. The format of the 
command is 



1^ 



{slot number} I CONTROL |-P 

A PRINTER command to slot number will switch the stream of 
output characters back to the Apple lie's video display. 



Warning 

Don't give the ph Inter command with slot number to deactivate the 
80-column firmware, even though you used this command to 
activate il in slot 3. The command works, but it just disconnects the 
firmware, teaving some of the soft-switches set for 80-cotumn 
display. 



102 



Using the Monitor 



In much the same way that the PRINTER command switches the 
output stream, the keybdard command substitutes the interface 
card in a specified expansion slot for the Apple lie's normal input 
device, the keyboard. The format for the keyboard command is: 



{slot number} | control |-k 

A slot number of for the kEVEOARD command directs the Monitor 
to accept input from the Apple lie's buitt-in keyboard. 

The PR INTER and KEYBOARD commands are the exact equivalents of 
the BASIC commands PR' and in*. For more information on the 
way those commands worK. refer to the section The Standard I/O 
Links" in Chapter 3. 

Hexadecimai Arithmetic 

The Monitor wi!l also perform one-byte hexadecimal addftion and 
subtraction. Just type a tine in one of these formats: 



{value} 

{value} 



{value} 
{value} 



The Apple Me performs the arithmetic and displays the result, as 
shown in these examples; 

•20+13 

-33 

*4A-C 

-3E 

•FF+4 

-03 

•3-4 

-FF 
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Special Tricks with the Monitor 

This section describes some more complex ways of using the 
Monitor commands. 



M 



Muttipie Command Lines 

You can put as many Monitor commands on a single line as you 
like, as long as you separate them with spaces and the total 
number of characters in the line is less than 254. Adjacent 
single-letter commands such as l, 5, I, and N need not be 
separated by spaces. 

You can freely intermix all of the commands except the STQre (: ) 
command. Since the Monttor takes all values following a colon 
and places them in consecutive memory locations, the last value 
in a STORE must be followed by a letter command before another 
address is encountered, Vou can use the normal command as the 
required letter command in such cases; it usually has no effect 
and can be used anywhere. 

In ttie following example, you display a range of memory, change 

it. and display it again, all with one line of commands. 

• 300.307 300:18 69 1 N 300.302 

0300- t}a 00 00 00 OO OO 00 00 
O300- 18 69 01 



t 



Jf the Monitor encounters a character in the input line that it does 
not recognize as either a hexadecimal digit or a valid command 
character, it executes all the commands on the input line up to 
that character, then grinds to a halt with a noisy beep and 
ignores the remainder of the input tine. 



Fining Memory 

The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern 
in the first locations in the range: 



iu. 
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• 300:11 22 33 
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Remember the number of values in the pattern: in this case, it is 
3. Use ttie number to compute addresses for the MOVE command, 
like this: 

{start+number} < {start} . {end-number} M 

This T^OVE command will first replicate the pattern at the locations 
immediately following the original pattern, then replicate that 
pattern following itself, and so on until it tills the entire range. 

*303<300.32Dfyl 
•300,32F 



0300- 


n 


22 


33 


1 1 


22 


33 


1 1 


22 


0308- 


33: 


11 


22 


33 


11 


22 


33 


1 1 


0310- 


22 


33 


11 


22 


33 


11 


22 


33 


031 a- 


1 1 


22 


33 


1 1 


22 


33 


1 1 


22 


0320- 


33 


1 1 


22 


33 


11 


22 


33 


1 1 


0328- 


22 


33 


11 


22 


33 


11 


22 


33 



You can do a similar trick wfth the VERIFY command to check 
whether a pattern repeats itself through memory. This is 
especially useful to verify that a given range of memory locations 
all contain the same value. In this example^-you first fill the 
memory range from *30 to *320 with zeros and verify it. then 
change one location and verify again, to see the VERIFY 
command detect the discrepancy: 

* 300:0 

*301<300.31FIVI 

•30K300.31FV 

•304:02 

•30K300.31FV 



0303-00 I02J 
0304-02 too) 
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Repeating Commands 

You can create a command line that repeats one or more 
commands over and over You do this by beginning the part of 
the command line that you want to repeat with a letter command, 
such as N. and ending it with the sequence 34: n, where n is a 
hexadecimal number that specifies the position in the line of the 
command where you want to start repeating; for the first 
character in the line. n-0. The value for n must be followed with 
a space in order for the loop to work properly. 

This trick takes advantage of the fact that the Monitor uses an 
index register to step through the input buffer starting at location 
S200 . Each time the Monitor executes a command, it stores the 
value of the index at location »3^; when that command is 
finished, the Monitor reloads the index register with the value at 
location *34. By making the last command change the value at 
location *34, you change this index so that the Monitor picks up 
the next command character from an earlier point in the buffer 



The only way to stop a loop like this is to press [ control] - 
[ RESET I ; that is how this example ends 






lU^ 



#N 300 302 34 


0300- 


n 


0302- 


33 


0300- 


11 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


11 


0302- 


33 


0300- 


11 


0302- 


33 


0300- 


11 


0302- 


33 


030 




« 
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Creating your Own Commands 



The USER command J_c ONTRQin -y . forces the Monitor to jump to 
memory location *3FB, You can put a JtiP instruction there that 
jumps to your own machine-ianguage program. Your program 
can then examine the Monitor's registers and pointers or the 
input buffer itself to obtain its data. For example, here is a 



Urn 



loe 
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program th at displays everything on the input line after the 

) C0NTR0l1 "Y . The program starts at location *300: the command 

line that starts with *3Fa stores a jump to *300 at location *3F8. 

*300:A4 34 B9 00 02 20 ED FD C8 C9 8D DO F5 4C 69 FF 
*3F8:4C 00 03 



* [ CQNTRDLl -Y THIS IS A TEST 
THIS rs ft TEST 

Machine-Language Programs 

The main reason to program in machine language is to get more 
speed. A program in machine language can run much faster than 
the same program written in high-fevel languages such as BASIC 
or Pascal, but the machine-language version usually takes a lot 
longer to write. There are other reasons to use machine 
language; you might want your program to do something (hat 
isn't included in your high-level language, or you might just enjoy 
the challenge of using machine language to work directly on the 
bits and bytes. 

If you have never used machine language before, you'll need to 
learn the 6502 insinjcOons listed In Appendix A To become 
proficient at programming In machine language, you'll have to spend 
some lime al il, and sludy one of the books on 6502 pn:>grammiog 

lifted In the Bibliography. 

You can gel a hexadecimal dump of your program, move it 
around in memory, or save it on tape and recall it again using 
the commands described in the previous sections. The Monitor 
commands in this section are intended specifically for you to use 
in creating, writing, and debugging machine- language programs. 

Running a Program 

The Monitor command you use to start execution of your 
machine-language program is the GU command. When you type 
an address and the letter G, the Apple lie starts executing 
machine language instructions starting at the specified location. If 
you just type the &, execution starts at the last opened bcation. 



Machine-language Programs 




The Monitor treats this program as a subroutine: it should end 
with an RTs (return from subroutine) instruction to transfer control 
back to the Monitor, 

The Monitor has some special features that make It easier for 
you to write and debug machine-language programs, but before 
you get into that, here is a small machine-language program that 
you can run using only the simple Monitor commands already 
described. The program in the example merely displays the 
letters A through 2: you store it starting at location *300, examine 
it to be sure you typed it correctly, then type 300G to start it 
running, 



i>300:A9 CI 20 ED FD 18 69 1 C9 DB DO F6 60 
•300 30C 



03QO- A9 C1 20 ED FD 18 G9 01 
0308- C9 DB DO F6 60 






'300G 



AecDEFGHlJKLMNOPQRSTUVWXYZ 



Since programs that translate assembly 
lanQuage ioEo machine langjage are 
called assemblers, a prog rami lil^e the 
Morilor's u i 5T command Ihat translates 
machine language into assembly 
larguagB is called a disassembler. 



The word mnemonic comes from the 
same root as memory and relers to 
short acranyms thai are easier to 
remember than tlie hexadecimal 
operation codes themselves: lor 
exampie, for clear carry you write CLC 
instead ot tie. 



Disassembled Programs 

Machine-language code in hexadecimal isn't the easiest thing In 
the world to read and understand. To make this iob a little 
easier, machine-language programs are usually written in 
assembly language and converted into machine-language code 
by programs caHed assemblers. 

The Monitor's LIST command displays machine-language code in 
assembly-language torm. Instead of unformatted hexadecimal 
gibberish, the lest command displays each instruction on a 
separate line, with a three-tetter instruction name, or mnemonic, 
and a formatted hexadedmat operand The list command also 
converts the relative addresses used in branch instaictions to 
absolute addresses. 
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The Monitor LIST command has ihe format: 

{tocation} L 

The LIST command starts at the specified location and displays 
as much memory as it takes to make up a screenfull (20 lines) of 
instructions, as shown in the following example: 

*300L 



0300- 


A3 


CI 


LDfl 


'$C1 


0302- 


20 


£D FD 


JSR 


*FDED 


0305- 


18 




CLC 




0306- 


69 


01 


ADC 


'«01 


0308- 


CS 


DB 


CMP 


'«DB 


030A- 


DO 


F6 


BNE 


*030e 


030C- 


60 




RTS 




030D- 


00 




9RK 




030E- 


00 




BRK 




030F- 


00 




BRK 




0310- 


00 




BRK 




0311- 


00 




BRK 




0312- 


00 




BRK 




0313- 


00 




BfiK 




0314- 


QO 




BI^K 




0315- 


00 




BRK 




0316- 


GO 




BRK 




0317- 







BRK 




03ie- 


DO 




BRK 




0319- 


00 




BRK 





The tirst seven tines of this example are the assembly-language 
form of the program you typed In the previous example. Tne rest 
of the lines are BRK instructions only if this part of memory has 
zeros in it: other values will be disassembled as other 
instructions. 

The Monitor saves the address that you specify in the LIST 
command, but not as the last opened location used by the other 
commands. Instead, the Monitor saves this address as the 
program counter, which it uses only to point to locations within 
programs. Whenever the Monitor performs a LIST command, it 
sets the program counter to point to the location immediately 
foilowing the last location displayed on the screen, so that if you 
type another LIST command it will display another screenfull of 
instructions, starting where the previous display 
left off. 
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The Mini-assembler 

Without an assembler, you have to write your machine language 
program, take the hexadecimal values for the opcodes and 
operands, and store them in memory using the commands 
covered in the previous sections. That is exactly what you did 
when you ran the previous examples. 

The integer BASIC interpreter includes an assembler called the 
Apple Mini-assembler that enables you to type programs into the 
Apple lie using the same assembly-language format that the LIST 
command displays. It Is called a mini -assembler because it 
doesn't include symbolic labels, an important feature of all full- 
sized assemblers like the Assembler/Editor in the DOS Tool Kit 
(Apple product number A2D0029). 



U 



^ 



Before you can use the Mini-assembler, the Apple Me has to be 
running Integer BASIC. When you start up the computer using 
DOS or either BASIC, the Apple lie loads the Integer BASIC 
interpreter from the file named INTbAS IC into the bank switched 
RAM. 



To run Integer BASIC after you have started up the computer 
with DOS, type 



IHT 



The Apple lie displays the Integer prompt character 
cursor. 



and a 



If you have nol activated the SO-calumn firmware since you started 
up with DOS, the cursor now looks like a blinking rectangle: it is 
actually a space character displayed in flashing formal. This is 
ewidence that the old Monitor is operating {see Chapter 3). The old 
f\^onitor is loaded Into RAM along with Integer BASIC and the mini- 
assernblef: the next time you activate the SO-coJumn firmware, it 
copies the current version of the Monitor from ROM into RAM. Once 
this has happened, the current Monitor is active even with Integer 
BASIC, and the cursor is either a blirrking chGckerboard or a steady 
rectangle. 



Now enter the Monitor by typing 



CALL -151 



lUi 
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After you enter the Monitor from Integer BASIC, invoke the Mini- 
assembler by typing: 

FB6B& 

This iS just the 00 command described above starting the 
program stored at location *F6GS — the mini assembier. You can 
tell that the mini-assembler is running because it displays an 
exdamalion point (' ) as its prompt character. While the mini- 
assembler is running, you can execute any Monitor command by 
preceding it with a dollar sign (*). Aside from that, the Mini- 
assembler has an instruction set and syntax all its own. 

The Mini-assembler saves one address, that of the program 
counter. Before you start to type a program, you must set the 
program counter to point to the location where you want the Mini- 
assembler to store your program. Do this by typing the address 
followed by a colon. 

After the colon, type the mnemonic for the first instruction in your 
program, followed by a space and the operand of the instruction 
(formats for operands are listed Table 5-1). Now press [ return J . 
The Mini -assembler converts the line you typed into hexadecimal, 
stores it in memory beginning at the location of the Program 
Counter, and then disassembles it again and displays the 
disassembled line. It then displays a prompt on the next fine. 

Now the Mini-assembler is ready to accept the second instruction 
in your program. To tell it that you want the next instnjction to 
follow the first, dont type an address or a colon: just type a 
space and the n e?ct instruction's mnemonic and operand, then 
press [ RETURN | . The Mini-assembler assembles that line and waits 
for another. 

If the line you type has an error in it, the Mini-assembler beeps 
loudly and displays a circumflex {'*) under or near the offending 
character in the input line Most common errors are the result of 
typographical mistakes: misspelled mnemonics, missing 
parentheses, and so forth. The Mini-assembler also rejects the 
input line if you forget the space before or after a mnemonic or 
include an extraneous character in a hexadecimal value or 
address. It the destination address of a branch instruction is out 
of the range of the branch (more than 127 locations distant from 
the address of the instruction), the Mini-assembler flags this as 
an error. 



The Mini-assembter 



til 



■300:LDX #02 
0300- A2 02 
i LDA SO<X 
0302- BB OD 
< STA $10,X 
0304- 95 10 
* OEX 

0306- CA 

! STA $C030 

0307- 9D 30 CO 
! BPL $302 
Q30fl- 10 FB 

! BRK 
03DC- 00 



LDX '»0S 



LDA tOO^X 



STA *10,X 



D£X 



STA *C030 



BPL «0302 



BRK 



There are two ways to leave the Miniassembler and re-enter the 
Monitor. One way is to type the Monitor command, FF690, 
preceded by a dollar sign: 

!$FFG9G 



Another way to leave the Mini-assembler is to press I CONTROL 
[ RESET ] , which warm-Starts BASIC^ then type 



CALL-151 
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Your assembly language program is now stored in memory. You 
can display it with the list command: 



•30DL 



0300- 


fl2 


02 


LDX 


*«02 


0302- 


BS 


00 


LDA 


soo,x 


0304- 


95 


10 


STA 


$to»x 


0306- 


Cfl 




DEX 




0307- 


3D 


30 CO 


STfl 


tC030 


030ft- 


10 


F6 


BPL 


S03OE 


030C- 


00 




BRK 




030D- 


00 




BRK 




030E- 


OD 




BRK 




030F- 


00 




BRK 




0310- 


00 




BRK 




0311- 


00 




BRK 




0312- 


00 




BRK 




031 3- 


00 




BRK 




0314- 


00 




BRK 




0315- 


00 




BRK 




031G- 


DO 




BRK 




0317- 


00 




BRK 




0318- 


00 




BRK 




0319- 


00 




BRK 





Mini-assembler Instruction formats 

The Apple Mint-assembler recognizes 56 mnemonics and 13 
addressing tormats used in 6502 assembiy-language 
programming. The mnemonics are standard, as used in the 
Synertek Programming Manual (Apple part number A2L0003). but 
the addressing formats are somewhat different. Table 5-1 shows 
the Apple standard address-mode formats for 6502 assembly 
language. 

An address consists of one or more hexadecimal digits. The 
Mini-assembler interprets addresses the same way the Monitor 
does: If an address has fewer than four digits, the Mini-assembler 
adds leading zeros; if the address has more than four digits, then 
it uses only the last four. 

In this bcx3k, doUar sigrts (*) in addresses signify Ihal the addresses 
are in hexadecimal notation. They are ignored by the Mini- 
assembler and may be omitted when typing programs. 

There is no syntactical distinction between the absolute and zero- 
page addressing modes. If you give an instruction to the Mini- 
assembler that can be used in both absolute and zero-page 
mode, the Mini-assembler assembles that instruction in absolute 
mode if the operand for that instruction is greater than »ff, and it 
assembles it in zero-page mode if the operand is less than *-ioo. 
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Table 5-1 

Formal s 



Mini -assembler Address 



Addressing Mode 



Format 



Nates 



"Mole: Accumulator and 
Implled-address insSnjctions have no 
operands. 



AccumjJator 

Implied 

Immediate 

Absolute 

Zeropaga 

Indexed zero page 

Indexed absolute 

Relative 

IndeKed indirect 
Indirect indexed 
Absolute indirect 



'f {value ^ 

S{ address [ 

({address I 

if address}, X 
({address], ¥ 

■»{address}, X 
({address}, V 

*{ address } 

(s{ address [, x) 

(*{ address [), Y 

(({address}) 



Instructions in accumulator mode and implied addressing mode 
need no operands. 

Brancti instructions, which use the relative addressing mode, 
require the target address of the branch. The Mini-assembler 
calculates the relative distance to use in the instruction 
automatically. If the target address is more than 127 locations 
distant from the instruction, the Mini -assembler sounds a beJI 
(beep), displays a circumflex {*) under the target address, and 
does not assemble the line. 

If you give the Mini-assembler the mnemonic for an instruction 
and an operand, and the addressing mode of the operand cannot 
be used with the instruction you entered^ the Mini-assembier will 
not accept the line, 



y^ 



f14 
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^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^H 


^^^~^ 






B"^ 


^^^^^^^^^^^^^^^^^^^^^1 ^?i MW^Mfv% ^^mj jf^w AjV^^ A4 a A^^ 


r\ J 


B~^ 


^^^^^^^^H Ou/Tini3/y or mOnilOt ^^uiinnaiiua 

Here is a summary of the Monitor commands, showing the 
syntax diagram for each one. The Mini-assembler commands are 
included, even though they are only available when Integer 
BASIC is active (see the section "The Mini-assembler"). 




Examining Memory 






{adrs} 


Examines the value contained 
in one location. 


^S"^ 


{adrs1},{adrs2} 


Displays the vafues contained 
in all locations between 
{adrsl} and {adrs2}. 


1 RETURN 1 


Displays the values in up to 
eight locations following the 
fast opened location. 


^5"^ 


Changrng the Contents of Memory 


^E""^ 


{adrs}:{val} {val},.. 


Stores the values in 
consecutive memory locations 
starting at {adrs}. 


^m J 


:{valHvaJ}.., 


Stores values in memory 
starting at the next changeable 
location. 


W^ - 


Moving and Comparing 




^S ^ 


{dest}<{s1art}.{enct}M 


Copies the values in the range 
{start}. {end} into the range 
beginning at {dest}. 


^B""^ 


{d9st}<{start}.{eTid}v 


Compares the values in the 
range (start). {end} to those in 
the range beginning at {dest). 


^B"*^ 
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The Register Command 

[^QNTROLj-E 



Cassette Tape Cornmands 

-[start|.{end}W 

{start}. {end>R 



Displays the locations where 

the contents d the 6502"s 
registers are stored and opens 
them fof changing. 



Writes the values In the 
memory range {start}. {end} 
onto tape, preceded by a ten- 
second leader. 

Reads values from tape. 
storing them in memory 
beginning at {start} and 

stopping at {end}. Prints "ERR' 
if an error occurs. 



Miscellaneous Monitor Commands 



I 
N 

LcdhtrdlI -b 

rCQNTROL [ ~C 

{val} + {val} 
{val}-{val} 



Sets Inverse display mode. 

Sets Normal display mode. 

Enters the language currently 
active {usually Applesoft). 

Returns to the language 
currently active (usually 
Applesoft). 

Adds the two values and prints 
the hexadecimal result. 

Subtracts the second value 
from the first and prints the 
result. 
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{slot} [ CDNTRDL \ -P 



CONTROL 



Diverts output to the device 
whose interface card ib in slot 
number {slot}, tf ^slotHOn 
accepts input from the 
keyboard. 

Jumps to the rnachine 
language subroutine at location 



Running and Ltsting Programs 

{adr&]-G 



{adrsj-L 



Transfers control to the 
machine language program 

beginning at {atjrsj^. 

Disassembles and displays 20 
instructions, starting at {adrs}. 
Subsequent Ls display 20 
more instructions. 



The Mini-assembler is only availably 
when Integer BASIC Is active. 



The Mini-assembler 

F6G6& 

*{ command j- 



Invokes the Mini-assembler. 

Executes a Monitor command 
from the Mini-assembler. 



IFFS9G 



Leaves the Mini-assembler. 



Summary of Monitor Cornmands 
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Chapter 6 



Programming for 
Peripheral Cards 



The seven expansion slots on the Apple lie's main circuit board 
are used for installing circuit cards containing the hardware and 
firmware needed to interface peripheral devices to the Apple lie. 
These slots are not simple I/O ports: peripheral cards can 
access the Apple lie s data, address, and control lines wia these 
slots. The expansion siots are numbered from 1 to 7, and certain 
signals, described below, are used to select a specific slot. 

Ttie older Apple II and Apple II Plus models have an eighth 
expansion slot! slot number 0. On those models, slot is normally 
used for a language card or a ROM card; the functions of the 
Apple II Language Card are bul(t into the main circuit board of ttie 
Apple Me. 



Penpherahcard Memory Spaces 

Because the Apple lie's 6502 microprocessor does all of its l;'0 
through memory locations, portions of the Apple lie's memory 
space have been allocated for the exclusive use of the cards in 
the expansion slots, h addition to the memory locations used tor 
actual I/O, there are memory spaces available for programmable 
memory (RAM) m the main memory and for read-only memory 
(ROM or PROM) on the peripheral cards themselves. 

The memory spaces allocated for the peripheral cards are 
described below. Those memory spaces are used for small 
dedicated programs such as I/O drivers. Peripheral cards that 
conlam their own driver routines in firmware like this are called 
intelligent peripherals. They make it possible for you to add 
peripheral hardware to your Apple lie without having to change 
your programs, provided ihat your programs follow normal 
practice for data input and output. 
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Table fi-1 Penpneral card I/O 
Memory Localiorg 

Note; Th& enabling signal is marked 
with a prime, to indicate that ii is an 
actrve-law signal. 



Peripheral-card IfO Space 

Each expansion slot has the exclusive use of sijcteen memorv 
locations for data input and output in the memory space 
beginning at location *C090. Slot 1 uses locations «CQ90 through 
*C09F, slot 2 uses locations »COflo through *C0AF, and so on 
through location «COFF, as shown in Table 6-1. 

These memory locations are used for different I/O functions, 
depending on the design of each peripheral card. VWhenever the 
Apple Me addresses one of the sixteen I/O locations allocated to 
a particular slot, the signal on pin 41 of that slot, called device 
SELECT' , switches to the active (low) state. This signal can be 
used to enable logic on the peripheral card that uses the four 
low-order address tines to determine which of its sixteen I/O 
locations is being accessed. 



Slot 



Locations 



Enabled by 



Z 
3 
4 
5 



»CD30 

tCOflO' 
ICOBO 

tccco 

• CODO 

*COEO 
tCOFO 



-»C09F 
-iCQAF 
-ICOBF 
-*COCF 
-tCODF 
-tCOEF 
-tCQFF 



DeVICE SELECT' 
DEVICE SELECT' 
DEVICE SELECT' 
DEVICE SELECT' 
DEVICE SELECT' 
DEVICE SELECT' 
DEVICE SELECT' 



Peripherai-oard ROM Space 

One 256-byte page of memory space is allocated to each 
peripheral card. This space is normally used for read-only 
memory (ROM or PROM) on the card with driver programs that 
control the operation of the peripheral device connected to the 
card. 

The page of memory allocated to each expansion slot begins at 
location scnOO, where n is the slot number, as shown in Table 6-2 
and Figure 6-3. Whenever the Apple Me addresses one of the 



i 
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256 ROM memory locations allocated to a particular slot, the 
signal on pin 1 of that slot, called [^Q select', switches to the 
active (low) state. This signal enables the ROM or PROM 
devices on the card, and the eight low-order address lines 
determine which of the 256 miemory locations is being accessed. 




Table 6-2 Peripheral-card ROM 

Memory Locations 


Slot 


Locations Enat>led by 






^5"--" 


Note: The enabling signal «s marked 
with a prime, lo irsdicals iNal it is an 
active-low signal. 


1 

2 


*CtQO-*ClFF I/DSELECT' 
*C200-tcaFF l/D SELECT' 






3 


*C300-*C3FF I/DSELECr 






4 


«C40C-«C^FF [/□ SELECT' 






5 


«C50C-»CSFF I/D SELECT' 



If there is an BO-column text card in&talled in the auxiliary slot, some 
ot the functions normafly associated with slot 3 are performed by 
the BO-column text card and the built-in 80-column firmware With a 
80-column text card installed, the i/o select' signal is not available 
for stot 3, so firmware in ROM on a card in slot 3 ma not run. 



Expansion ROM Space 

In addition to the small areas of ROM memory allocated to each 
expansion slot, peripheral cards can use the 2K-b7te memory 
space from f CBOO to *cfff for larger programs in ROM or PROM. 
This memory space is called expansion ROM space (see the 
memory map in Figure 6-3). Besides being larger, the expansion 
ROM memory space is always at the same locations regardless 
o1 which slot is occupied by the card, making programs that 
occupy this memory space easier to write. (See the section "I/O 
Programming Suggestions", below.) 

This memory space is available to any peripheral card that needs 
it. More than one peripheral card can have expansion ROM on it, 
but only one of them can be active at a time. 
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Each peripheral card that uses expansion ROM must have a 
circuit on it to enable the ROM. The circuit does this by a two- 
stage process: first, it sets a flip-flop when the I /D SELECT' signal, 
pin 1 on the slot, becomes active (low); second, it enables the 
expansion ROM devices when the l/D strobe ' signal, pin 20 on 
the slot, becomes active (low). Figure 6-1 shows a typical ROM- 
enable circuit. 

The 1/0 SELECT' signal on a particular slot becomes active 
whenever the Apple lie s 6502 microprocessor addresses a 
location in the 256-byte ROM address space allocated to that 
slot. The l/Q STROBE' signal on all of the expansion slots becomes 
active (low) when the 6502 addresses a location in the 
expansJon-ROM memory space, fCBOO-$CFFF. The i/D STROBE' 
signal is used to enable the expansion-ROM devices on a 
peripheral card (see Figure 6-1). 

If there is an BO-colurrn text card installed in the auxiliary stot, some 
of the functions normally associated with slot 3 are performed by 
the text card and tfie built-in 80-column firmware. With the text card 
installed, the t/D strobe' signai i$ not available on slot 3, so firmware 
in expansion ROM on a card in slot 3 will not run. 



tat. 

u 



Figure 6-1 

CJrcjil 



Expansion ROM EnabJe 




(l O strobT} 



ADDRESS 



AO TO A10 



A program on a peripheral card can get exclusive use of the 
expansion ROM memory space by referring to location *cfff in 
its initialization phase. This Jocatlon is special: all peripheral cards 
that use expansion ROM must recognize s reference to *CFFF as 
a signal to reset their ROM-enable flip flops and disabJe their 
expansion ROMs. Of course, doing so also disabies the 
expansion ROM on the card That is about to use il^ but the next 
instruction in the initialization code sets the fiip-flop on the 
expansion-ROM enable circuit on the card. Once this has been 
done, this card has exclusive use of the expansion memory 
space and its program can jump directly into the expansion 
ROf\/l. 

As described above, the expansion-ROM disable circuit resets 
the enable flip-flop whenever the 6502 addresses location *CFFF 
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Figure 6-2 ROM Disable Address 
Decadinig 




To RESET, ROM enable 
flrp-fjop 



(lO STROBE^ P^ 



To do this, the peripheral card must detect (he presence of *crrF 
on the address bus. You can use the uu strdse ' signal for part 
of the address decoding, since it is active for addresses from 
*C8t)0 through *CFFF. if you can afford to sacrifice some ROM 
space, your can simplify the address decoding even further and 
save circuitry on the card. For example, if you give up the last 
256 bytes of expansion ROM space, your disable circuit only 
needs to detect addresses of the form *cf>cx. and you can use 
the minimal disable-decoding circuitry shown in Figure 6-2. 



Table R-i Peripheral-card RAM 
MeiTiory Localions 

'Note: The RAM locations normally 
allocated to sbt 3 are taken aver by 
any card installed in the auKJIiary slot. 



Peripheral-card RAM Space 

There are 56 bytes of main memory allocated to the peripheral 
cards, eight bytes per card, as shown in Table 6-3. These 56 
locations are actually in the RAM memory reserved for the text 
and lowresolution graphics displays, but these particular 
locations are not displayed on the screen and their contents are 
not changed by the built-in output routine C0UT1 . Programs in 
ROM on peripheral cards use these locations for temporary data 
storage. 



Base 

Address 


1 


2 


Slot Nufnt»r 
3" 4 


5 


6 


7 


jQ-fye 


*Q179 


t047fl 


«047B* 


t047C 


»047D 


»047E 


t047F 


ta^FB 


*0^F9 


*04FA 


t04FB« 


t04FC 


f04FD 


104FE 


*Q4FF 


*C57B 


*QS79 


*057fl 


*057B* 


«057C 


»0b7D 


»0S7E 


«0S7F 


*D5Fe 


»0SF3 


»OSFA 


tOSFB* 


tOSFC 


fOSFD 


iOSFE 


tOSFF 


♦ □G7B 


»0679 


*0B7fl 


♦oe7B* 


$0S7C 


»067D 


»067E 


»Q&7F 


♦ QGFB 


»06F3 


IDbFA 


tOSFB" 


*06FC 


lOSFD 


iOBFE 


*06FF 


♦ 0778 


to 779 


t077A 


*Q77B« 


ia77C 


»077D 


*Ci77E 


t[)77F 


»Q7Fe 


*07F9 


t07FA 


*Q7FB- 


t07FC 


*07FD 


S07FE 


taipf 
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A program on a peripheral card can use the eight base 
addresses shown in the table to access the eight RAM locations 
allocated for its use, as shown in the next section, 'I/O 
Programming Suggestions". 

tlO Programming Suggestions 

A program In ROM on a peripheral card should work no matter 
which siot the card occupies. If the program includes a jump to 
an absolute location in one of the 256-byte memory spaces, then 
the card will only work when it is plugged into the siot that uses 
that memory space. If you are writing the program tor a 
peripheral card that will be used by many people, you should 
avoid placing such a restriction on the use oi the card. 

To function properly no maHer whfeh slot a peiipheral card Is 
installed in, the prograni in the card s 256-byte memory space must 
not make any absofute reterences to itself Instead of using jump 
instruclEons. you should force conditions on branch instructions, 
which use relative addre^ing. 

The first thing a penpheral-cafd subroutine should do is to save 
the contents ot the 6502's registers. One way to do this is to use 
the monitor subroutine iDSftVE. This subroutine, which starts at 
location tFF4A, stores the registers in zero-page memory locations 
«4S-*4e. A companion subroutine, IDREST, restores the registers 
from these memory locations. Your program should cali lOREST. 
which starts at location *FF3F Just before it returns control to the 
program that called it 

This method of saving the registers is convenient, but it is not 
always sate, If a second subroutine cafis lOSAve, or if an interrupt 
occurs, the new register contents get saved in the same 
locations, and the old ones get destroyed. It is safer, though 
somewhat slower, to save the registers on the stack, and restore 
them just before returning control to the calling program. 

Most single-character I/O is done via the 6502's accumulator. A 
character being output through your subroutine will be in the 
accumulator with its high bit set when your subroutine is called. 
Likewise, if your subroutine is performing character input, it must 
leave the character in the accumulator with its high bit set when 
it returns to the calling program- 



i 

'J 

J 

3 
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Finding the Slot Nutnti&r 

The memory addresses used by a program on a peripheral card 
differ depending on which expansion slot the card is installed in. 
Before it can refer to any of those addresses, the program must 
somehow determine the correct slot number. One way to do this 
is to execute a JSR (Jump to Subroutine) to a location with an RTS 
(Return from Subroutine) instruction in it, and then derive the slot 
number from the return address saved on the stack, as shown in 
the following example. 



PHP 
SEI 

JSR »FF5a 

TSX 

LDA (0100, 

AND '*0F 

PLP 



save status 

inhibit interrupta 

-> a known RTS instruction 

gel high byte of the. . . 

...return address from stack 

low -order digit is slot no. 

restore status 



The slot number can now be used in addressing the memory 
allocated to the peripheral card, as shown below. 

I/O Addressing 

Once your peripheral-card program has the slot number, It can 
use it to address the I/O locations allocated to the slot. Table 6-4 
shows how these locations are related to sixteen base addresses 
starting with ICOBO. Notice that the difference isetween the base 
address and the desired I/O location has the form *nO. where n 
is the slot number Starting with the slot number in the 
accumulator, the following example computes this difference by 
four left shifts, then loads it into an index register and uses the 
base address to specify one o1 sixteen I/O locations. 



ASL 
flSL 
flSL 
ASL 
TAX 
LDA •COBG.X 



get n into. . . 



, . .hiqh-order nybble. . , 
... of ind^x register, 
load from first !/□ loce 



it ion 



You must make sure that you get an appropriate value into the 
index register when you address I/O locations this way. For 
example, starting with 1 In the accumulator, the instructions in the 
above example perform an lda from location *C030, the first I/O 
location allocated to slot 1. If the value in ifie accumulator tiad been 
0, the LDA would have accessed tocalion tcoso, thereby setting the 
soft switch that selects the second bank of RAM at location *dqoo 
and enables rt tor reading (see Chapter 5). 
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Table 6^ Perlpheral-cerd I/O B99& 
Addresses 



Base 
Address 


1 


2 


Connector Number 
3 4 5 


9 


7 


tCDSO 


*C090 


SCOAO 


tCQBD 


• coco 


tCDDD 


ICQEO 


«C&FO 


tcoei 


*ca9i 


*C0fl1 


*C0B1 


*C0C1 


tCODi 


tCOEl 


icon 


tCD82 


»C092 


4C0A2 


SC0B2 


*C0C2 


*C0D2 


iCCFg 


*C0F3 


*C083 


iC093 


4C0ft3 


SC0B3 


*C0C3 


«CCD3 


JC0E3 


tCQF3 


*COS^ 


iC09^ 


*COA* 


*CQB4 


tcnc4 


tCOD-* 


*C0E4 


4C0F4 


tC085 


tC095 


*C0A5 


*C0B5 


iCOGS 


tCODS 


*CDES 


*CDF5 


• C086 


*C09e 


«C0A6 


SCQB6 


tcace 


tCQD6 


tCOEG 


*CQFe 


*C087 


*C097 


*C0ft7 


IC0B7 


iCOC? 


»cnD7 


tC0E7 


»C0F7 


«C088 


tcose 


tCGAS 


tCOBS 


tCDCS 


IC0D8 


»C0E8 


iCOFS 


• C089 


*C099 


1C0A9 


«C0B9 


tcncB 


*CCD9 


»CDE9 


tCOFS 


tC08A 


*C09fi 


tCOAA 


tCQBA 


tcncA 


tCCDA 


«COE^ 


tCQFA 


*C08B 


»C09B 


*COAB 


tCQBB 


tcncB 


tCCDB 


tCOEB 


tCQFB 


<cosc 


*C09C 


*noAC 


tCOBC 


(CDCC 


(CCDC 


CCOEC 


*COFC 


tcoeD 


JC09D 


tCOAD 


ICQBD 


tCOCD 


tCQDD 


tCOED 


*caFD 


ICOBE 


*C{)9E 


iCOAF 


tCOBE 


*COCE 


tCODE 


ICOEE 


fCOFE 


ICOSF 


*C09F 


»COAF 


SCOBF 


tcncF 


•CODF 


• GOEF 


«COFF 



RAM Addressing 

A program on a peripheral card can use the eight base 
addresses shown in Table 6-3 to access the eight RAM locations 
allocated tor its use. The program does this by putting its slot 
number into the Y hdex register and using indexed addressing 
mode with the base addresses. The base addresses can be 
defined as constants because they are the same no matter which 
slot the peripheral card occupies. 

If you start with the correct slot number in the accumulator (by 
using the example shown earlier), the following example uses all 
eight RAM locations allocated to the slot. 



3 

3 



a 
"J 



hl^ 



HU 
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TftY 
LOfK 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 



•0478. t 

*04F8,V 
S057B,¥ 

•05FB,Y 
*0S78,V 
fOGF8,V 
*077B,V 
«07F8,y 



Warning 

Peripheral card programs must not store data at the baso-address 
locations ihemselves; the RAM at those locations is used by Ihe 
Disk Operating System. DOS stores the first byte of the ROM 
location of the expansion slot that is currently active (SCn) in 
location »7F8, and the first byte of the ROM location of the slot 
holding the conlroJler card for Ihe startup disk drive in location *5f^ 



Changing ihe Standard 910 Links 

There are two pairs of locations In the Apple lie that are used for 
controlling character input and output. They are called the 1,0 
links {see Chapters). In a Apple lie running without a Disk 
Operating System, the I/O links normally contain the starting 
addresses of the standard input and output routines key IN and 
CQUT1 , If a disk operating system is running, one or both of the 
links will hofd the addresses of the DOS input and output 
routines- 

The link at locations »3e and* 37 (decimal 54 and 55) is called csw. 
for Character output Switch. Individually, location *3B is called 
CSWL (CSW Low) and location *37 is called C5WH (csw High). This link 
hoJds the starling address of the subroutine the Apple lie is 
currently using for single character output. This address is 
normally *rDFO , the address of routine cauTi , described In 
Chapters. 



When you issue a PR'n from BASIC or an n | CONTROL I -P from the 
Monitor the Apple He changes this link address to the first 
address in the ROM memory space allocated to slot number n. 
That address has the form *cnoo. Subsequent calls for character 
output are thus transferred to the program on the peripheral card. 
That program can use the Instruction sequences given above to 
find its slot number and use the I/O and RAM locations allocated 
to it. When it is finished, the program can execute an Rts (Return 
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Ircm Subroutine) instruction to return control to the calling ^ 

program, or jump to the output routine cOUTi at location *fdFo to _ 

display the output character (which must be in the accumulator) ^ 

on the screen, then let coun return to the calling program, - 

A similar link at locations *3a and *39 {decimal S6 and 57} is ^ 

called KSW, for Keyboard input Switch. Individually, location *3e is , 

called KSWL (for Ksui Low) and location * 39 is called kSWH (k Sw High). J 

Thts link holds the starting address of the routine currently being g 
used for single-character input. This address is normally *fdib, 
the starting address of the standard input routine key IN (see 

Chapters). g 

When you iss ue an iN'n command from BASIC or an _J 

n rcD KTRDL [ -K from the monitor the Apple Ite changes this ^ 

link address to »CnOO, the beginning of the ROM memory space ^ 

that is allocated to slot number n Subsequent calls for character • 

input are thus transferred to the program on the peripheral card. ^ 

That program can use the instruction sequences given above to , 

find its slot number and use the I/O and RAM locations allocated _; 

to it. The program should put the input character, with its high bit t 
set, into the accumulator and execute an RTS (Return from 

Subroutine) instruction to return control to the program that ^ 

requested input. g 

When the Disk Operating System (DOS) is running, one or both ^ 

of the standard I/O links hold addresses of the Disk Operating ^ 

System's input and output routines. The DOS has internal 

locations that hold the addresses of the character input and 

output routines that are currently active. g 

If a program that is omning with DOS changes the standard link 

addresses, either directly ar via IN» and PR' commands. DOS is L 

disconnected from the system. " 

To avoid disconnecting DOS each time they initiate I/O to a slot, £ 

BASIC programs that run with DOS must always issue an IN' or " 
a PR' command from inside a PR INT statement that starts with a 

\ cONTRaL r P character. For assembly-language programs, there is £ 

a DOS subroutine cail to use when changing the iink addresses. ■■ 
After changing csw or kSw. the program calls this subroutine at 

location *3EA (decimal 1002). The subroutine transfers the link g 

address to a location inside DOS and then restores the DOS "- 
address in the standard link location. Refer to the section on 
input and output link registers in the DOS Manual for further 
details. 
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Using tnterrupts 

Although programs runnfng on the Appfe Me do not normally use 
interrupts, it is possibie to do so. To use interrupts on the 
Apple lie, your peripheral card must be able to send an interrupt 
request (IRQ') to the 5502 microprocessor, and you must store 
the address of your interrupt-handling routine in the user inlerrupt 
vector, as described below. 

Fnterrupt priority is handled by a daisy-chain arrangement using 
two pins, INT IN and int out. on each expansion slot As 
described in Chapter 7, each peripheral card breal^s the chain 
when it makes an interrupt request. On peripherai cards that 
don't use interrupts, these pins should be connected together. 
The daisy chain gives priority to the peripheral card ir> siot 7: if 
this card opens the connection between IHT in and int out. or if 
there is no card in this siot, interrupt requests from cards in slots 
1 through 6 cant get through. Simiiarly. slot 6 controls IRQ from 
siots 1 through 5, and so on down the iine. 

When the IRQ' line on the 6502 microprocessor Is activated 
(pulled low), the 6502 transfers controi through the vector in 
locations *FFFe'tFFFF. This vector is the address of the fvlonitor's 
interrupt handler, which determines whether the request is due to 
an externa] IRQ or a BRK instruction and transfers contro! to the 
appropriate routine via the vectors stored in memory page 3. The 
BRK vector is in iocations *3F0-*3Fi and the [RO vecJor is in 
locations *3FE-»3FF (see Table 4-10). The Monitor normally stores 
the address of its reset routine In the I RQ vector; you should 
substitute the address of your program's interrupt-handling 
routine. 

Other Uses of 110 Memory Space 

The portion of memory space from location *cooo through *CFFF 
(decimal 49i B£ through B3247) is normally allocated to I/O and 
program memory on the peripherai cards, but there are two other 
functions that also use this memory space; the built-in self-test 
firmware and the SO-column display firmware. The soft switches 
that control the allocation of this memory space are described 
below. 
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Figure 5-3 I/O Memory Map 
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Switching IIO Memory 

The bujit-in firmware uses two soft switches to control the 
allocation of the I/O memory space from *C0OO to *CFFF. The 
locations of these soft switches. SLDTcxROr^ and slOTC3ROM, are 
given in Table 6-5. 

Like the display switches described in Chapter 2, these soft switches 
share their locations with the keyboard data and strobe functions. 
The switches are activated oniy by writing, and the stales can be 
determined only by reading, as indicated in Table 6-5. 

When SLOTCSRori is on^ the 256-byte ROM area at »C300 is 
available to a peripheral card in slot 3, which is the slot normally 
used for a terminal interface. It a card is installed in the auxiliary 
slot when you turn on the power or reset the Apple Me. the 
SLDTSRDM swItch is turned off. Turning SLaTcaRDM off disables 
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Table 6-5 I/O Memory Switches 



Name 



Function 



Location 
H«£ Decimal 



Notes 



SLOTCSROM SlolROMat »C3Q0 *C0OB 49163 -16373 Write 

Internal ROM at 4 C 30 Q SCOOA 49162 -1G374 Write 

Head SLQTC3H0M switch *C017 49175 -163GI Read 



SLOTCKRDM Slot ROM al «CxOQ 4C0D7 49159 -1G377 Write 

Internal ROM altCxOD »CODG 491 SB -1G37B Wnte 

Read SLQTCXRQM switch »C01S 49173 -1G3G3 Read 



peripheral-card ROM in slot 3 and enables the built-in 80-column 
firmware, as shown in Figure 6-3. The eO-column firmware is 
assigned to siot-3 address space because slot 3 is normally used 
with a terminal interface, so the built-in firmware will work with 
programs that use slot 3 this way. 

Installing an SO-column text card in the auxHiary sbt makes it 
impossible to run any peripheral card that has built-in firmware in 
slot 3. If an SD-column tesd card is not installed, a peripheral card in 
slot 3 ■^iW work properly. 

The bus and I/O signals are always available to a peripheral 
card in slot 3, even when the SO-column hardware and firmware 
are operating. Thus it is always possible to use this slot for any 
I/O accessory that does not have built-in firmware. 

When SLOTCXROM is active (high), the I/O memory space from 
•CI 00 to *C7FF is allocated to the expansion slots, as described 
previously. Setting SLDTcxRQri inactive (low) disables the peripheral- 
card ROM and selects built-in ROM in all of the I/O memory 
space except the part from tCOOO to*CDFF (used for soft switches 
and data I/O), as shown in Figure 6-3. In addition to the 80- 
column firmware al *C300 and *ceoo^ the built-in BOM includes 
firmware that performs the self-test of the Apple lie's hardware. 

Setting slotckromi low enables built-in ROM in all of the I/O memory 
space (except the aoft-switch area), including the tCSOO space, which 
contains the 80-coiumni firmware. 
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Chapter 7 



Hardware Implementation 



Most of this manual describes functions — what the Apple tie 
does. Ttiis chapter, on the other hand, describes objects: the 
pieces of hardware the Apple lie uses to carry out its functions, 
tf you are designing a piece of peripheral hardware to attach to 
the Apple lie. or if you just want to know more about how the 
Apple Me is buplt, you should study thjs chapter. 

Environmentai Specifications 

The Apple lie is quite sturdy when used in the way it was 
intended. Table 7-1 defines the conditions under which the 
Apple lie is designed to function properly. 



J&b\e 7-1 Summary of Environmental 

Specificalions 



Operating TemperaUrei 0"^ to 4&*C (30' to 11 S'F) 

Helalive Humidity: 5% to 85% 

Une Voltage: 1 07 to 1 33 VAC 



You should treat the Apple Me with the same kind of care as any 
other electrical appliance. You should protect it from physical 
violence, such as harnmer blows or defenestration. You should 
protect the mechanical keyboard and the electrical connectors 
inside the case from spilled liquids, especially those with 
dissolved contaminants, such as coffee and cola drinks. 

In normal operation, enough air flows through the slots in the 
case to keep the insides from getting too hot, although some of 
the parts inside the Apple lie normally get rather warm to the 
touch. If you manage to overheat your Apple lie, by blocking the 
ventilation slots in the top and bottom for example, the first 
symptom will be erratic operation. The memory devices in the 
Apple Me are sensitive to heat: when they get too hot, they 
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occasionally change a bit of data. The exact result depends on 
what kind of program you are running and on just which bit of 
memory is affected- 

The Power Supply 

The power supply in the Apple lie operates on normal household 
AC power and provides enough low-voHage electrical power 
for the built-in electronics plus a full complement of peripheral 
cards, including disk controller cards and comn^unications 
interfaces. The basic specifications of the power supply are listed 
in Table 7-2. 

The Apple lie's power cord should be plugged into a three-wire 
110- to 120-volt outlet. You must connect the Apple Me to a 
grounded Outlet or to a good earth ground- Also, the line voltage 
must be in the range given in Table 7-2- If you try to operate the 
Apple Me from a power source with more than 140 volts, you will 
damage the power supply. 



'J 

■J 



t- 



Table 7-2 Power Supply 
Specifications 

■Jnlermitlent operaiiori; The Apple Ite 
can safaly operate for up to twenty 
minutes at the higher load if lollowed 
by at least ten minutes Si rvofmai 
load. 



Line voltage: 

Maximum power consumption; 

Supply VDltages: 



Maximum supply currenis; 



Maximum case temperature: 



107V to 132V AC 

eOW c-onlinuous 
aow intermittent' 

+5V ±3% 
+ 11.8V ±6% 
-5-2V +10% 

-lav ±10% 

+ 5V:2.5A 

+12V; T.5A contirnjous, 
2_5A intermittent* 
- 5 V: 250mA 
-12V; 250mA 

55"C(130^F) 



The Apple Me uses a custom-designed switching -type power 
supply. It is smali and lightweight, and it generates less heat than 
other types of powef supplies do. 

The Apple He's power supply works by converting the AC line 
voitage to DC and using this DC voltage to power a vanable- 
ffequency oscillator The oscillator drives a small transtormer with 
many separate windings to produce the different voltages 
required, A circuit compares the voltage of the -i-5-voH supply 
with a reference voltage and feeds an error signal back to the 
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oscillator circuit. The oscillator circuit uses the error signal to 
controt the frequency of its oscillation and keep the output 
voltages in their normal ranges. 

The power supply includes circuitry to protect itself and the other 
electronic parts of the Apple Me by turning off all four supply 
voltages whenever it delects one of the following malfunctions: 

■ any supply voltage short-circuited to ground; 

• the power-supply cable disconnected; 

* any supply voltage outside the normal range. 

Any time one of these malfunctions occurs, the protection circuit 
stops the oscillator, and all the output voltages drop to ^ero. After 
about half a second, the oscillator starts up again. If the 
malfunction is still occurring, the protection circuit stops the 
oscillator again. The power supply will continue to start and stop 
this way until the malfunction is corrected or the power is turned 
off. 



Warning 

It you think the power supply is broken, do not altempt to repair it 
yourself. The power supply i$ in a sealed enclosure because some 
of its circuits are connected directly to the power line. Special 
equipment is needed to repair the power supply safely, so see your 
Apple dealer for service. 



The Power Connector 

The cable from the power supply is connected to the main circuit 
board by a six-pin connector with a strain-relief catch. The 
connector pins are identified in Table 7-3 and Figure 7-1 4d. 



Table 7'3 Power Connector Signal 
Specifications 



Pin Number 



Name 



Description 



1^ 
3 
4 
5 



Ground Common electrical ground 

+5V +5V ifom power supply 

+12V +12V from power supply 

- 1 2V - 1 2V from power supp\y 

-5V -5V trom power supply 
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Table 7-4 S502 Microprocessor 
Specifications 



The 6502 Microprocessor 

The Apple lie uses a 6502B microprocessor as Its central 
processing unit (CPU). The 6502B in the Apple lie runs at a 
clock rate of 1 .023 MHz and performs up to 500,000 eight-bit 
operations per second:. You should not us$ the clock rate as a 
criterion for comparing different types of mioroprocessors. The 
6502 has a simpler instruction cycle than most other 
microprocessors and it uses instruction pipelining for faster 
processing. The speed of the 6502 with a 1 MHz clock is 
equivalent to other types of microprocessors with clock rates up 
to 2.5MH2. 

The 6502 has a sixteen-bit address bus, giving it an address 
space of 64K (2 to the sixteenth power or 65536) bytes. The 
Apple He uses special techniques to address a total of more than 
64K: see the sections "Bank -switched Memory" and "Auxiliary 
Memory and Firmware ' in Chapter 4 and the section "Switching 
I/O Memory" in Chapter 6. 



Type: 

Regis-ter comptement; 



Register sEze: 
Data JjLs: 
Address bus: 
Address range: 
Interrupts: 

Operating voiltage: 

Power dissipation: 



6502B 

Accurnulator (A) 
Indait Registers (X, Y) 
Slack Pointer [Si 
Processor Stalus (P) 

Eiglil bits 

Eight bits wid& 

Sixteen bils wtde 

65.536 (64K) 

IRQ (maskable) 
NMI (normas-kable) 
BRK Cpmgranimed) 

+5V (± 5%) 

SQDmW (typical) 



i 

J 

i 
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6502 Timing 

The operation of the Apple lie is controlled by a set of 
synchronous liming sfgnafs, sometimes called clock signals. In 
electronics, the word cfock is used to identify signals that control 
the timing of circuit operations. The Apple He doesn't contain the 
kind of clock you tell time by, although its internal timing is 
accurate enough that a program running on the Apple He can 
simulate such a clock. 

The frequency of the oscillator that generates the master timing 
signal is 14.31818 MHz, Circuitry in the Apple lie uses this clock 
signal, called i 4ri, to produce all the other timing signals. These 
timing signals perform two major tasks; controilmg the computing 
functions, and generating the video display. The timing signals 
directly Involved with the operation of the 6502 are described In 
this section. Other timing signals are described in the sections 
■'RAM Addressing". "Video Display Modes", and "The Expansion 
Slots'. 

The main 6502 timing signals are listed in Table 7-5. and their 
relationships are diagrammed in Figure 7-1 . The 6502 clock 
signais are f/)1 and 4>o, compiementary signals at a frequency of 
1.02273 MHz. If you need more information about the 6502 itself, 
refer to the Synertek Hardware Manual (Apple product number 
A2L0002). The Apple lie signal named (fro is equivalent to the 
signai called f/>2 In the hardware manual (it isn't identical: it's a 
tiny bit early). 



Tahla7-5 6503 Timing Signal 
Descripiions 



Signal Name 



14M 
7M 

*1 



Oescription 



Master osciilator. I4.318ie MHz; also BQ-coiumn dot cfock. 

fntermediare timing signal and 40-coiumn dot dock. 

JrHerTne<liate limrng signal, 2,04545 MHz with asymmetricaf duty 
cycle. 

Phase ot B502 clock. 1 .022727 MHz: Complement of <jy\. 

Phase t of 6502 clock. 1 .022727 MHz; Complemenl ot ifrC. 



The G502 Microprocessor 



141 



Figure 7-1 6502 Tiniiing Signals 
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The operations of the 6502 are related to the clock signals in a 
simple way: address during ^1. data during i^o The 6502 puts 
an address on the address bus during c/jI. This address is valid 
not 'ater than 11 D nanoseconds after f^1 goes high and remains 
valid through all of t^o. The 6502 reads or writes data during t^o. 
If the 6502 is writing, the read/write signal is low during 6o and 
the B5Q2 puts data on the data bus. The data is valid not later 
than 75 nanoseconds after Oo goes high. \i the 6502 is reading, 
ttie read/write signal remains high. Data on the data bus must be 
valid no later than 50 nanoseconds before the end o1 t^o. 
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Figur* 7-2 Hie MMU Pinouts 
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The Custom Integrated Circuits 

Most of the circuitry that controls memorv and I/O addressing in 
the Apple lie is in three custom integrated circuits called the 
Memory Management Unit (MMU). the Input-Output Unit (lOU), 
and the Programmed Array Logic device (PAL). Ttie soft switches 
used for controlling the various I/O and addressing modes of tfie 
Apple He are addressable flags inside the MMU and the lOU. 
The functions of these tv^fo devices are not as independent as 
their names suggest; working together, they generate all of the 
addressing signals. For exampfe, the MMU generates the 
address signals tor Ihe CPU, while the lOU generates similar 
address signals for the video display. 

The Metnory Management Unit 

The circuitry inside the MMU implements these soft switches, 
which are described in the following chapters: 

Page 2 display (PAGE^): Chapter 2 

Hi res mode (hires): Chapter 2 

Store to eO"COlumn card (SOSTORE): Chapter 2 

Seiect bank 2: Chapter 4 

Enable bank switched RAM: Chapter 4 

Read auxiliary memory (RAhRD): Chapter 4 

Write auxiliary memory (R/^MWRT): Chapter 4 

Auxiliary stack and zero page (ALTZP): Chapter 4 

Slo! ROM for connector #3 (SLDTC3R0n): Chapter 6 

Slot ROM in I/O space (SLOTcxROn): Chapters 

The 64K dynamic RAMs used in the Apple lie use a multiplexed 
address, as described below in the section Dynamic-RAM Timing" 
The MMU generates this multiplexed address for memory reading 
and writing by the 6502 CPU. 
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Table T-6 The MMU Signal 
Descnptions 



Pin Number 


Name 


Description 


1 


GHD 


Power and signak common 


g 


AO 


6502 actdress input 


40-26 


A1-fl15 


6502 address input 


3 


^ 


Clock phass 


4 


Q3 


Timing signal 


5 


PHAS' 


Merrvory Row-address strobe 


6-13 


Rfl0-Rfl7 


Multiplexed address output 


14 


R/U' 


6502 read-write control signal 


IS 


INH' 


lohibits main memory 


16 


DMA 


Conlroia data bus for DMA transfers 


J7 


ENOQ' 


Enables auxiliary RAM 


ia 


KBD' 


Enables keyboard data bit 0-6 


19 


R0nEN2' 


Enables bjilt-in fimiware ROM #S 


20 


ROMEHI 


Enables built-in fimiware ROM #1 


21 


MD7 


State oT MMU flags 


22 


RH'24B 


Controls 74LS245 data-bus bjffer 


23 


Rflr^EN' 


Enables main RAM 


24 


ex XX 


Enables periplieral-card memory 


25 


-sv 


Power 



i 

i 
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Figure 7-3 The 10 U PInouts 
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EO 
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The InputlOutput Unit 

The circuitry inside the Input/Output Unit (lOU) implements the 
foJIowJng soft switches^ all described in Chapter 2; 

Page 2 display (PflGE2) 

Hi-res mode (hires) 

Text mode (text) 

Mixed mode (mued) 

80-COlumn display (8QC0L) 

Character-set select (Altcharset) 

/\ny-key-down 

Annunciators 

Vertical blanking (VBU) 

The 64K dynamic RAMs used In the Apple lie require a multiplexed 
address, as described below in the section "Dynamic-RAM Timing ". 
The lOU generates this multipleKed address for the data transfers 
required for display and memory refresh during dock phase 1 The 
way this address is generated is described below in the section 
"Video Display Generation", 
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Table 7-7 The lOU Signal 


Pin Number 


Name 


Description 


OescriptionB 








Kote: Pin 1S is not connecl^d- 


1 


GHD 


Power and sjgrai common 




2 


GA 


Graphics mode enable 




3.4 


SEGA, 
SEGB 


Display verijcai countor bits 




S 


yc 


Display vfirtical counter bit 




fi 


BOVID' 


BO-coljmn video enable 




7 


CAS50 


Cassette nulput signal 




a 


SPKR 


Speaker □ulpirt signal 




9 


MD7 


Internal flags Id data bus 




10-13 


fiN0-flN3 


Annunciator outputs 




14 


R/W 


GS02 read'write control signal 




15 


RESET' 


Pdwer on and reset outpiil 




17-24 


RflO-RA7 


Mjltiplexed RAM address (phase □) 




25 


PftflS 


Rnw-address strobe (phase Q) 




26 


*0 


Masler clock phase 




27 


Q3 


Intemiediate timing signal 




2S 


+ SV 


Power 




29 


fve 


Address bit 6 from G502 




30 


COXX' 


I/O address enable 




31 


AKD 


Any-ksy-down signal 




32 


KSTRB 


Keyboard sirobe signal 




33, 34 


WID7, WID6 


Video display oontral bits 




35, 3G 


RA3'. RAIO' 


Video display control bits 




37 


CLRGAT' 


Color-biirst gale (enable) 




38 


UHDUJ 


Display blanking signal 




30 


BVNC 


Display synchronization signal 




40 


HO 


Display horizontal tming signal 



i 

a 

5 
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The PAL Circuit 

A Programmed Array Logic device, type PAL 16R8. generates 
several timing and control signals in the Apple lie. These signals 
are listed in Table 7-8. 



Table 7-8 The PAL Signal 
Oescri prions 



Pin NumlMr 



Name 



Dflftcrtption 



Figure 7-4 Ihe PAL PinouO 
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1 4,31 81 8 MHz master timing signal 

7.15909 MHz liming' signal 

3,579545 MHz timing signal 

Horizontal video (inning signal 

Video data bit 7 

Video timing signal 

Video display grap^iics-nniode enable 

RAM enable (CAS enabiej 

Enable flO-column Oisplay mode 

Power and signal common 

Enable master liming 

Videa shift- register load enable 

ViCco dot clock, 7 or 14 MHz 

Phase 1 system clock 

Phase sygtem ck?ck 

Intermediate timing and strobe signal 

RAM Column-address strobe 

{This pin IS not used-) 

RAM Row-address strobe 

Power 
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Memory Addressing 

The 6502 microprocessor can address 65.536 locations. The 
Apple Me uses this entire address space, and ttien some; some 
areas in memory are used for more than one lunction. The 
foSlowing sections describe the memory devices used in the 
Apple ile and the way they are addressed. Input and output also 
use portions of the memory address space; refer to the section 
"Peripheral-card Memory Spaces" in Chapter 6 for information. 
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ROM Addressing 

In the Apple lie. the following programs are permanently stored in 
two type 2364 8K by B-bit flOMs (read-only memory): 

• Applesoft editor and interpreter 

• Monitor 

• eo-column display firmware 

• Seif-test routines 

These two ROMs are enabled by two signals called RDMEN^ and 
RaKEN2. The ROM enabled by RDMENi , sometimes called the 
Diagnostics ROM, occupies the memory address space from 
1C1 00 to*DFFF.The address space from *C3O0 to*C3FF and from 
scaao to *CFFF contains the SO-column display fimiware. Those 
address spaces are normally assigned to ROM on a peripheral 
card in slot 3; for a discussion of the way the SO-column 
firmware overrides the peripheral card, see the section "Other 
Uses of I/O Memory Space" in Chapter 6, 

Two other portions of the Diagnostics ROM, addressed from 
«Ci00to*C2FFandfrom*C400 to *C7FF, contain the built-in selMest 
routines. These address spaces are normaHy assigned to the 
peripheral cards; when the self test programs are running, the 
peripheral cards are disabled. 

The remainder of the Diagnostics ROM, addressed from *D0O0 to 
♦dfff, contains part of the Applesoft BASIC interpreter. 

The ROM enabled by R0nEN2, sometimes called the Monitor ROM, 
occupies the memory address space from *E000 to »ffff. This 
ROM contains the rest of the Applesoft Interpreter, in the address 
space from «eooo to »efff, and the Monitor subroutines, from 
«FOOO to fFFFF. 
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Figure 7-5 The 2364 BOM Pinouls 
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The other ROMs in the Apple lie are a type 2316 ROM used for 
the keyboard character decoder and a type 2333 ROM used for 
character sets for the video display. This 2333 ROM is rather 
large because it includes a section of straight-through bit- 
mapping for the graphics modes. This way, graphics display 
video can pass through the same circuits as text without 
additional switching circuitry. 

RAM Addressing 

The RAM (programmable) memoiry in the Apple Ite is used both 
tor program and data storage and for the video display. The 
areas in RAM that are used for the display are accessed both by 
the 6502 microprocessor and by the video display circuits. In 
some computers, (his dual access results in addressing conflicts 
(cycle stealing) that can cause temporary dropouts in the video 
display- This problem does not occur in the Apple He, thanks to 
the way the microprocessor and the video circuits share the 
memory. 

The memory circuits in the Apple lie take advantage of the two- 
phase system clock described in the section "System Timing to 
interleave the microprocessor memory accesses and the display 
memory accesses so that they never interfere with each other 
The microprocessor reads or writes to RAM only during (/>0. and 
the display circuits read data only during th'l- 

Dynamic-RAM Refreshment 

The image on a video display is not permanent; it fades rapidly 
and must be refreshed periodically. To refresh the video dfsplay, 
the Apple lie reads the data in the active display page and sends 
it to the display. To preveni visible flicker in the display, and to 
conform to standard practice for broadcast video, the Apple Me 
refreshes the display sixty (imes per second 

The dynamic RAM devices used in the Appie Me also need a 
kind of refresh, because the data is stored in the form of electric 
charges which diminish with (ime and must be replenished every 
so often. The Appie lie is designed so that refreshing the display 
also refreshes the dynamic RAMs The next few paragraphs 
explain how this is done. 

The job of refreshing the dynamic RAM devices is minimized by 
the structure of the devices themselves. The individual data cells 
in each RAM device are arranged in a rectangular array of rows 
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Table 7-9 RAM Address Mtiltiptesirg 



Figure 7-e The 64K HAM Pimuls 
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and columns. When the device is addressed, the part of the 
address that specifies a row is presented first, followed by the 
address of the coJumn. Splitting information into parts that follow 
each other in time is called muttipfexing . Since only half of the 
address is needed at one time, multiplexing Ifre address reduces 
the number of pins needed for connecting the RAMs. 

Different manufacturers' 64K HAMs have cell arrays of either 128 
rows by 512 columns or 256 rows by 256 columns. Only the row 
portion of the address is used m refreshing the RAMs, 

Now consider how the display is refreshed. As described later In 
this chapter in the section "The Video Counters^ the display 
circuitry generates a sequence of 6,192 memory addresses in 
high-resolution mode; in text and low-resolution modes, this 
sequence is the 1 ,024 display page addresses repeated eight 
times. The disptay address cycles through this sequence 60 
times a second, or once every 17 milliseconds. The way the low- 
order address lines are assigned to the RAMs, the row address 
cycles through all 256 possible values once every half-millisecond 
(see Table 7-9). This more than satisfies the refresh 
requirements of the dynamic RAMs. 
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Dynamic-RAM Timing 

The Apple lie's microprocessor clock runs at a moderate speed, 
about 1 023 MHz, but the interleaving of CPU and display cycles 
means that the RAM is being accessed al a 2 MHz rate, or a 
cycle time of jusl under 500 nanoseconds. Data for the CPU is 
strobed by the falling edge of <fjO. and display data is strobed by 
the falling edge of t^l, as shown in Figure 7-9. 

The RAM timing looks complicated because the RAM address is 
multiplexed, as descfibed in the previous section. The MMU 
takes care of muitlplexing the address for the CPU cycle, and the 
lOU performs the same function for the display cycle, The 
multiplexed address is sent to the RAM ICs over the lines 
labelled RAO RA7, Along with the other timing signals, the PAL 
generates two signals that control the RAM addressing: Row- 
address Strobe (RAS) and CoJumn-address Strobe (CAS). 



Table 7-10 Dynamic RAM Timing 

Signals 



Signal Name 

*1 

RAS 

CftS 

Q3 

RA0-RA7 

MD0-MD7 



Description 



Clock phase (CPU phase) 
Clock phsse 1 (display phase] 
flow-address strobe 
Column-address slrobe 
Altgmalive column-actdress strabe 
Multiplexed address bus 
Internal data bus 
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Figure 7-9 RAM Timing Signals 
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The Video Display 

The Apple lie produces a video signal that creates a display on a 
standard video monitor or. if you add an RF modijlator, on a 
black-and-white or cotor television set. The video signal is a 
composEte made up ot the data that is being displayed plus the 
horizontal and vertical synchronization signals that the video 
monitor uses to arrange the lines of display data on the screen. 

Apple lies manufactured (or sal^ in the US generate a video signal 
that is compatible with the standards set by the NTSC (National 
Television Standards Committee) Apple lies manufactured for sale 
in European countnes generate video that is compatible with the 
standard used there, which is called PAL (for Phase Ailernating 
Lines). This manual describes only the NTSC version of the video 
circuits- 
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The display portion of the video signal is a time-varying voltage 
generated from a stream of data bits, where a one corresponds 
to a voltage that generates a bright dot, and a zero to a dark 
dot. The display bit stream is generated in bursts that correspond 
to the horizontal Hnes of dots on the video screen. The signal 
named undw js low during these bursts. 

During the time intervals between bursts of data, nothing is 
displayed on the screen. During these inten^als, caJled the 
blanking intervals, the display is bfank and the UNDW signal is 
high. The synchronization signals, called sync for short, are 
produced by making the signal named SVNC low during portions 
of the blanking intervals. The sync pulses are at a voltage 
equivalent to blacker-than-black video and don't show on the 
screen. 

The Video Counters 

The address and timing signals that control the generation of the 
video display are aJI derived from a chain of counters inside the 
EOU, Only a few of these counter signals are accessible from 
outside the lOU, but they are all important in understanding the 
operation of the display generation process, particularly the 
display memory addressing described in the next section. 

The horizontaf counter is made up of seven stages; HO, H1 , H2, H3, 
H4, H5, and HPE*. The input to the honzcnlal counter is the 1 MHz 
signal that controls the reading of data being displayed. The 
complete cycle of the horizontal counter consists of 65 states. 
The six bits HO through H5 count normally from to 63, then start 
over at 0. Whenever this happens, HPE' forces another count with 
HO through HS held at zero, thus extending the total count to 65. 

The lOU uses the forty horizontaf count values from 25 through 
64 in generating the iow-order part of the display data address, 
as described below in the section "Display Address Mapping' . 
The lOU uses the count values from to 24 to generate the 
horizontal blanking, the horizontal sync pulse, and the color-burst 
gate. 

When the horizontal count gets to 65, it stgnafs the end of a line 
by triggering the vertical counter. The vertical counter has nine 
stages: VA. VB, VC, VO, V1 , V2, V3, V4, and V5, When the vertical 
count reaches 262, the lOU resets it and starts counting again 
from zero. Only the first 192 scanning tines are actually 
displayed; the JOU uses the vertical counts from 192 to 261 to 
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generate the vertical blanking and sync pulse. Nothing is 
displayed during the vertical blanking interval. (T\)B vertical line 
count is 262 rather than the standard 262.6 because, unlike ■ 
normal television, the Apple lie's video display is not interlaced. 

Animation displays sometimes have an erratic flicker caused by 
changing the display data at the same time It is being displayed. 
You can avoid this on the Apple lie by reading the vertical-blanking 
signal (vbl) at location *cdi9 and only changing display data while 
VBL is low (data value less than 12S). 



Display Memory Addressing 

As described in Chapter 2 in the section 'Addressing Display 
Pages Directly", data bytes are not stored in memory in the 
same sequence in which they appear on the display. You can 
get an idea of the way the display data is stored by using the 
Monitor to set the display to graphics mode, then storing data 
starting at the beginning of the display page at tiexadedmal *40Q 
and watching the effect on the display. If you do this, you should 
use the graphics display instead of text to avoid confusion: the 
text display is also used for Monitor input and output. 

If you want your program to display data by storing it directly into 
the display memory, you must first transforTn the display 
coordinates Into the appropriate memory addresses, as shown in 
Chapter 2. The descriptions that follow will help you understand 
how this address transformation is done and why it is necessary. 
They will not (alas!) eliminate that necessity. 

The address transformation that folds three rows of forty display 
bytes into 128 contiguous memory locations is the same for all 
display modes, so it is described first. The differences among the 
different display modes are described in the section 'Video 
Display Modes', below. 

Display Address Mapping 

Consider the simplest display on the Apple lie, the 40-column 
text mode. To address forty columns requires six bits, and to 
address twenty-four rows requires another five bits, for a total of 
eleven address bits. Addressing the display this way would 
involve 2048 (two to the eleventh power) bytes of memory to 
display a mere 960 characters. The 80-co1umn text mode would 
require 4096 bytes to display 1920 characters. The leftover 
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Figure 7-10 Display Address 
Transformation 



chunks of memory that were not displayed could be used for 
storing other data, but not easily, because they would not be 
contiguous. 

Instead of using the horizontal and vertical counts to address 
memory directly, the circuitry inside the iOU transforms them inio 
ihe new address signals described below. The transformed 
display address must meet the following criteria: 

• Map the 960 bytes of 40-coJumn text into only 1024 bytes. 

• Scan the low-order address to refresh the dynamic RAMs. 

• Continue to refresh the RAMs during video blanking. 

The requirements for RAfyl refreshing are discussed above, in the 
section "Dynamic-RAM Refreshment' . 

The transformation involves only horizontal counts H3, H^, and hs. 
and vertical counts V3 and V4. Vertical count bits va, vb, and vc 
address the lines making up the characters, and are not involved 
in the address transformation. The remaining low order count 
bits, Hc, HI , HS, VQ, VI , and V£ are used directly, and are not 
involved in the transformation. 

The IOU performs an addition that reduces the five significant 
cx>unt bits to four new signals called SO, 5i , S2, and S3, where S 
stands for sum. Figure 7-10 is a diagram showing the addition in 
binary form, with V3 appearing as the carry in and HS appearing 
as its complement H5\ A constant value of one appears as the 
low-order bit of the addend. The carry bit generated with the sum 
is not used. 
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If this transformation seems terribly obscure, try it with actual 
values. For example, for the upper-left corner of the display, the 
vertical count is zero and the horizontal count is 24: HO, H1 , H2, 
and H5 are zeros and hb and H4 are ones. The value of the sum 
is zero, so the memory location for the first character on the 
display is the first location in the display page, as you might 
expect. 
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Figure 7-11 40-column Text Display 

Mernory. Memory tocatJons marked with 
an asterisK ^'J are reserved for use by 
periphera) I/O linniware; refer to the 
section "Peripheral-card RAM Space", 
kn Cnapler 6. 



Horizontal bits ho. hi , and H2 and sum bits so. si , and S£ mal^e up 
the transformed horizontal address [AO through AG in Table 7-11). 
As the horizontal count increases from 24 to 63, the value of the 
sum (53 S2 SI SO) increases from zero to four and the transformed 
address goes from to 39. relative to the beginning of the 
display page. 

The low-order three bits of the vertical row counter are vo, vi , 
and V2. These bits control address bits A7, as, and A9. as shown 
in Table 7-1 1 . so that rows through 7 start on 128-byte 
boundaries. When the vertical row counter reaches 8, VO, yi , and 
V2 are zero again, and V3 changes to one. If you do the addition 
in Figure 7-10 with h equal to 24 (the horizontal count for the first 
column displayed) and v equal to 8, the sum is 5 and the 
horizontal address is 40; the first character in row 8 is stored in 
the memory location 40 bytes from the beginning of the display 
page. 
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Figure 7-1 1 shows how groups of three forty-character rows are 
stored in blocks of 120 contiguous bytes stalling on 128-byte 
address boundaries. This diagram is another way of descnbing 
the display mapping shown in Figure 2-5- Notice that the three 
rows in each block of 120 bytes are not adjacent on the display 
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T^le 7-1 1 Display Memory 
Addressirg 
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Table 7-12. 
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Table 7-1 1 shows how the signals from the video counters are 
assigned to the address lines, ho. hi . and H2 are horizontal-count 
bits, and vo. vi , and V2 are vertical-count bits. SO, 5i , S£ and S3 
are the tolded address bits described above. Address bits 
marked with asterisks (* ) are different for different modes; see 
Table 7-12 and the next three sections. 
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Video Display Modes 

The different display modes all use the address-mapping scheme 
described in the previous section, but they use ditferent-si?ed 
memory areas in different locations. The next three sections 
describe the addressing schemes and the methods of generating 
the actual video signals for the different display modes. 

Text Disptsys 

The text and iow-resolulion graphics pages begin at memory 
locations *400 and »aoo Table 7-12 shows how the dispiay-mode 
signals control the address bits to produce these addresses. 
Address bits A10 and A11 are controlled by PG2 and 80VID, which 
are set by the display-page and 90-column-video soft switches. 
Address bits A12. Ai 3. and Ai -4 are set to zero. Notice that 8CVID 
active inhibits PG2: there is only one display page in 80-co3umn 
mode. 

The low-order six bits of each data byte reach the character 
generator dtrectly, via the video data bus vido-vidb The two high- 
order bits are modified by the lOU to select between the primary 
and alternate character sets and are sent to the character 

generator on lines Rfl9 and RAi o. 

The data for each row of characters are read eight times, once 
for each of the eight lines of riots making up the row of 
characters. The data bits are sent to the character generator 
along with Vfl, VB, and vc, the low-order bits from the vertical 
counter. For each character being displayed, the character 
generator puts out one of eight stored bit patterns selected by 
the three-bit number made up of Vf^, VB, and VC. 
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Figure l-^Z Video Timing SignaEs 



The bit patterns from the character generator are loaded into the 
74166 parallel-to-serial shift register and output as a serial bit 
stream that goes to the video output circuit. The shift register is 
controlled by signals named ldPS' (for load parallel-to-serial 
shifter) and v I D7M (for video 7 Mhz^. In 40-column mode. LDPS ' 
strobes the output of the character generator into liie shift 
register once each microsecond, and VID7M shifts the bits out at 7 
MHz. 

The addressing for the 80-column display is exactly the same as 
for the 40-column display: the 40 columns of display memory on 
the SO-column card are addressed in parallel with the 40 columns 
in main memory. The data from these two memories reach the 
video data bus (lines Vl DO- V1D7) via separate 74LS374 three-s!ate 
buffers. These buffers are loaded simultaneously, but their 
outputs are sent to the character generator alternately by (f>o and 
(jbl. In 80-column mode, LDPS' loads data from the character 
generator into the shift register twice during each microsecond. 
once during (t>o and once during </)1, and viD7ri runs at 14 MHz to 
shift the data bits out twice as fast. 
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Table 7-13 Character generalor 
Conirol Signals 



Lov^-ResoiuUon Dispf&y 

In the graphics modes, VA and VB are not used by the character 
generator, so the lOU uses lines SEGA and SE&B to Uansmit ho and 
HIRES', as shown in Table 7-13. 



DfSplsy mode 

Text 
Graphics 



SEGfl 



SEGB 



SCGC 



VA 

HO 



VB 

HIQES' 



vc 
vc 



The low-resolution graphics display uses vc to divide the eight 
display lines corresponding to a row of clnaracters into two 
groups of four lines each. Each row of data bytes is addressed 
eight times, the same as in text mode, but each byte is 
interpreted as two nybbles. Each nybble selects one of sixteen 
colors. During the upper four of the eight display fines, vc is low 
and the low-order nybble determines \he color. During the lower 
four display lines, vc is liigh and the high-order nybbie 
determines the color. 

The bit patterns that produce the low-resolution colors are read 
from the character-generator ROM in the same way the bit 
patterns for characters are produced In text mode. The 74166 
parallel-to-serial shift register converts the bit patterns to a serial 
bit stream for the video circuits. 

The video signal generated by the Apple Me includes a short 
burst of 3.58 MHz Signal that is used by an NTSC color monitor 
or color TV set to generate a reference 3. 58 MHz color signal. 
The Apple lies video signal produces color by interacting with 
this 3.58 MHz signal inside the monitor or TV set. Different bit 
patterns produce different colors by changing the duty cycles and 
delays of the bit stream relative to the 358 MHz color signal, To 
produce the small delays required for so many different colors, 
the shift register runs at 14 MHz and shifts out 14 bits during 
each cycle of the 1-MHz data clock. To generate a stream of 
fourteen bits from each eight-bit pattern read from the ROM, the 
output of the shift register is connected back to the register's 
serial input to repeat the same eight bits; the last two bits are 
ignored the second time around. 
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Each bit pattern ra output for the same amount of time as a 
character; 1.02 microseconds. Because that is exactly enough 
time for three and a half cycles of the 3,58 MHz color signal, the 
phase relationship between the bit patterns and the signal 
changes by a haif cycle for each successive pattem. To 
compensate for this, the character generator puts out one of two 
different bit patterns for each nybble. depending on the state of 
HO, the iow-order bit of the horizontal counter. 

High-ReBOiution Display 

The high-resolution graphics pages begin at memory locations 
*20O0and*'1O00 (decimaiB19£ and 1G384). These page addresses 
are selected by address bfts Ai 3 and A1 4. In high-resolution mode, 
these address bits are controlled by PG£ and 80VID, the signals 
controlled by the display-page (PAGE2) and flO-column -video 
(BOCDL) soft switches. As in text mode, soviD Inhibits addressing of 
the second page because there is only one page of 80-column 
text available for mixed mode 

fn high-resolution graphics mode, the display data are still stored 
in blocks like the one shown in Figure 7-11, but there are eight 
of these blocks. As Tabie 7-1 1 and Table 7-12 show, vertical 
counts VA, VB, and vc are used for address bits At 0, Ai i , and Ai 2, 
which address eight blocks of 1024 bytes each. Remember that 
in the display Vfl. vb, and vc count adjacent horizontal lines in 
groups of eight. This addressing scheme maps each of those 
lines into a different 1024-byte block. It might help to think of ft 
as a kind of eight-way multiplexer: it's as if eight text displays 
were combined to produce a single high-resolution display, with 
each text display providing one iine of dots in turn, instead of a 
row of characters. 

The high resolution bit patterns are produced by the character- 
generator ROM. In this mode, the bit pattems simpfy reproduce 
the eight bits of display data. The low-order six bits of data reach 
the ROM via the video data bus vido-vids. The lOU sends the 
other two data bits to the ROM via RA9 and RAi o. 

The high resolution colors described in Chapter 2 are produced 
by the interaction between the video signal the bit patterns 
generate and the 3,58 fylHz color signal generated Inside the 
monitor or TV set. The high-resolution bit patterns are always 
shifted out at 7 MHz, so each dot corresponds to a halt-cycle of 
the 3,58 MHz color signal. Any part of the video signai that 
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produces a single white dot between two black dais, or vice- 
versa, is effectively a short burst of 3. 58 MHi and is tfierefore 
displayed as color. In other words, a bit pattern consisting of 
alternating ones and zeros gets displayed as a line of color. The 
high- resolution graphics subroutines produce the appropriate bit 
patterns by masking the data bits with alternating ones and 
zeros. 

To produce different colors, the bit patterns must have different 
phase relationships to the 3.58 IvlHz color signal. If alternating 
ones and zeros produce a certain color, say green, then 
reversing the pattern to zeros and ones will produce the 
complementary color, purple. As in the low-resolution mode, each 
bit pattern corresponds to three and a half cydes of the color 
signal ^ so the phase relationship between the data bits and the 
color signal changes by a half cycle for each successive byte of 
data. Here, however, the bit patterns produced by the hardware 
are the same for adjacent bytes; the color compensation is 
performed by the high-resolution software, which uses different 
color masks for data being displayed in even and odd columns, 

To produce other colors, bit patterns must have other timing 
relationships to the 3.58 MHz color signal. In high-resotulion 
motie, the Apple lie produces two more colors by delaying the 
output of the shift register by half a dot (70 ns), depending on 
the high-order bit of the data byte being displayed, (The high- 
order bit doesn't actually get displayed as a dot, because at 
7 MHz there is only time to shift out seven of the eight bits.) 

As each byte of data is sent from the character generator to the 
shift register, high-order data bit D7 is aiso sent to the PAL If D7 
is off, the PAL transmits shift-register liming signals LDPS* and 
VI D7M normally. If D7 is on, the PAL delays LDPS ' and v id7M by 70 
nanoseconds, the time corresponding to half a dot. The bit 
pattern that formerly produced green now produces orange; the 
pattern for purple now produces blue. 

A note about liming: For 8(H;olumn text, the $tiift register is clocked 
at twice normal speed When aO-column text is used with graphics 
in mixed mode, the PAL controls shift-register timing signals lDPS' 
and viD7n so that the graptiics portion ol the display works correctly 
even when the text window is in 80-column mode. 
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Video Output Signats 

The stream of video data generated by the display circuits 
described above goes to a linear summing circuit built around 
transistor Ql where It is mixed with the sync signals and the 
color burst. Resistors R3. R5, R7, RIO. R13, and R15 adjust the 
signals to the proper amplitudes, and a tank circuit (L3 and C32) 
resonant at 3.58 MHz conditions the color burst. 

The resulting video signal is an NTSC compatible composite 
video signal that can be displayed on a standard video monitor. 
The signal is similar to the EIA (Electronic Industries Association) 
standard positive composite video (see Table 7-14). This signal is 
avaifable in two places in the Apple lie: 

• At the phono jack on the back of the Apple lie. The sleeve of 
this jack fs connected to ground and the tip is connected to 
the video output through a resistor network that attenuates it 
to about 1 volt and matches its impedance to 75 ohms. 

• At the internal video connector on the Apple lie circuit board 
near the RCA jack, J13 in Figure 7-14c. It Is made up of four 
Molex-type pins, 0.25 inches tall on 0.10 inch centers. This 
connector can'ies the video signal, ground, and two power 
supplies, as shown in Table 7-14, 



Tal>le7-14 Internal Video Connector 
Signals 



Pin Number 

1 
2 



3 

4 



Namfr 



Description 



GROUND Syslem common ground 

VIDEO NTSC-coitipatible posrtive composite video. While 

level is aboul 2.Q uolt^, black level is about 0,75 

volts, and sync level is O.Q votls. This Qutpul is rial 
protected againsl short circuits. 

- 5 V - 5 volt power su pply 

+ 1 2V +12 woll power supply 



The Video Display 



16^ 



Built-in itO Circuits 

The use ot the Apple He's buiEI-in I/O features is described in 
Chapter 2 This section describes the hardware implementation of 
all ot those features except the video display described in the 
previous sections. The lOU (input/Output Unit) generates the 
output signals for the speaker the cassette interface, and the 
annunciators dfrectly. The other I/O features are handled by 
smaller IGs, as described below. 

The addresses of the buiit-in I/O features are described in 
Chapter 2 and listed in Table 2-2, Table 2-11, and Table 2-12. All 
of the built-in I/O features except the displays use memory 
locations between tcooo and »CQ70 (decimal ^91 52 and 49264), 
The I/O address decoding is performed by three ICs: a 74LS138, 
a 74LS1 54. and a 74LS251 

The 74LS138 decodes address lines AS, A9, Al 0. and Al 1 to select 
address pages on 256-byte boundaries starting at *C0O0 (decimal 
49152) When it detects addresses between tCOOO and *coFF, it 
enables the lOU and the 74LS154. The 74LS154 in turn decodes 
address lines A4, A5, A6, and p\7 to setect 16 byte address areas 
between «C0Q0 and*coFF. Addresses between *coso and *C0GF 
enable the 74LS251 that multiplexes the hand control switches 
and paddles; addresses between *C070 and tCQ7F reset the 
NE55S quadruple timer that interfaces to the hand controls, as 
described below in the section Game I/O Signals'. 
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The Keyboard 

The Apple lie's keyboard is a matrix of keyswitches connected to 
an AY-3600-fype keyboard decoder via a ribbon cable and a 26- 
pin connector. The AY-3600 scans the array of keys over and 
over to detect any keys pressed. The scanning rate is set by the 
external resistor-capacitor network made up of C70 and R32, The 
debounce time is also set externally, by C71. 

The AY-3G00's o utputs inclu d e five brts of key code plus 
separate lines for | caNTRaLn , | ' SHIFT | , any-key-down > and keyboard 
strobe, The any-key-down and keyboard -strobe lines are 
connected to the lOU, which addr esse s them as sof t switches. 
The key-code lines, along with I CQNTRQLj and [jhTfT] , are inputs 
to a separate 2316 ROM. The ROM translates them to the 
character codes that are enabied onto the data bus by signals 
namedKBD' and enkbd' . The kbD' signal is enabled by the MM U 
whenever a program reads location *CO0Q. as described in 
Chapter 2. 
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Table 7-IS Keyboard Connectar 



Pin Number 


Name 


DescripUofi 


1,2,4, 






6, a, 10, 






23, 25, 






12,22 


ro-¥9 


Y-direction key-matrix connections 


3 


+ 5 


+5 volt supply 


5, 7, 9, 15 


n. c, 

LCISTL" 




1 


Line Irom \ CONTROL kBy 


13 


GND 


Systern common ground 


14. 16, 






20.21. 19. 






26. 17 


LSHFT' 


X-direction key-matrix connectfons 


24 


Line from | SHIFT | key 



Connecting a Keypad 

There is a smalter connector wired in parallel with the keyboard 
connector. You can connect a ten-key numeric pad to the 
Appte lie via this connector. 



Table 7-1& Keypad Connector Signals Pin Number 



Name 



Description 



r 2, 5, 

3, 4, 6 



VO-YB 
n. c. 



Y-directJon key-matrix connections 



9, 11. 

10. e 



x^-x7 



X-direcllon key-matnx connedions 
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Table 7-17 Speaker Conneclor 

Signals 



Cassette HO 

The two miniature phone jacks on the back of the Apple Me are 
used to connect an audio cassette recorder for saving programs. 
The output signai tc the cassette recorder comes from a pin on 
the lOU via resistor network R6 and R9. which attenuates the 
signal to a level appropriate lor the recorder s microphone input. 
Input from the recorder is amplified and conditioned by a type 
74 1 operational amplifier and sent to one of the inputs of the 
74LS251 input multiplexer. 

The signal specifications for cassette \iO are: 

Input; 1 volt (nominal) from recorder Earphone or Monitor 
output. Input impedance Is 12K ohms. 

Output: 25 millivolts to recorder Microphone input. Output 
impedance is 100 ohms. 



"3 



The Speaker 

The Apple lie's built-in loudspeaker is controlled by a single bit of 
output from the IQU (Input Output Unit) The signal from the lOU 
is AC coupled to Q5, an MPSA13 Darlington transistor amplifier. 
The speaker connector is a f^olex KK100 connector. J18 in 
Figure 7 14b. with two square pins 0,25 inches tall and on 0-10- 
inch centers, 

A tight-emitting diode is connected in parallel across the speaker 
pins such that, when the speaker is not connected, the diode 
glows whenever the speaker signal is on. This diode is used as 
a diagnostic indicator during assembly and testing of the 
Apple tie. 



%dm 



UU 



Pin Number Mnnw 



Description 



SPKR Speaker signal- TWs line will deliver about 0,5 

watts into an 8-ohm speaker. 

+ s +5V power supply. Noie that the speaker Is not 

connected to system ground- 



I 
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Game IIO Signals 

Several I/O signals that ar& individually controlled via soft 
switches are collectively referred to as the game signals. Even 
though they are normally used for hand controls, these signals 
can be used for other simple I/O applications. There are five 
output signals: the lour annunciators, numbered P\Q through f\3, 
and one strobe output. There are three one-bit inputs, called 
switches and numbered swo through swe, and four analog inputs, 
called paddles and numbered pdlo through PDL3. 

The annunciator outputs are driven directly by the lOU (Input 
Output Unit). These outputs can drive one TTL (transitor-transitor 
logic) load each; for heavier loads, you must use a transfStor or a 
TTL buffer on these outputs. These signals are only available on 
the 16-pin internal connector (see Table 7-18). 

The strobe output is a pulse transmitted any time a program 
reads or writes to location *C040. The strobe pin is connected to 
one output of the 74LS1S4 address decoder This TTL signal is 
normally high; it goes low dunng i^)0 of the instruction cycle that 
addresses location *co^o. This signal is only available on tbe 16- 
pin internal connector (see Table 7-18). 

The game inputs are multiplexed along with the cassette input 
signal by a 74LS251 eight-input multiplexer enabled by the coex' 
signal from the 74LS1S4 I/O address decoder. Depending on the 
low-order address, the appropriate game input is connected to bit 
7 of the data bus. 

The switch inputs are standard low-power Shottky TTL inputs. To 
use them, connect each one to 220 ohm pull-up resistors 
connected to the +5-vo!t supply and through single-pole. 
momentary-contact pushbutton switches to ground. 

The hand-control inputs are connected to the timing inputs of an 
MESSe quadruple 555-type analog timer. Addressing •C07x sends 
a signal from the 74LS154 that resets all four timers and causes 
their outputs to go to one (high). A variable resistance of up to 
150K ohms connected between one of these inputs and the +5V 
supply controls the charging time of one of four 0.022-microfarad 
capacitors. When the voltage on the capacitor passes a certain 
threshold, the output of the NE558 changes back to zero (low). 
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Table 7-18 Game I/O Connector 

Signals 



Programs can determine the setting of a variable resistor by 
resetting the timers and tlien counting time until the selected 
timer input changes trom high to low. The resulting count is 
proportional to the resistance. 

The game I/O signals are alE available on a 16-pin DfP socket 
labelled GAME I/O on the main circuit board inside the case. 
The switches and the paddies are also available on a D-type 
miniature connector on the back of the Apple Me: see J8 and J15 
in Figure 7-1 4d. 



Internal' 
Connector 
Pin Number 



Back panel- 
Connector 
Pin Niimtjer 



Signal; 
Name 



Description 



2.3, 4 



7. 1.6 



6. 10,7,11 



5, 8. 4. 9 



+ EV +5 power supply. Total 

curreni drain from this pin 
must rot exceed lOOmA, 

PB0^PB2 Switch Inputs, Thes© are 
Starkdard 74LS inputs. 

STROBE' Strobe oulpul- Ttiis line goes 

low during dO ot a read or 
write irstrjciion to location 
»C04D. 

PDLO - PDL 3 Hand control inputs. Eacti of 
these should be connected 
to a l50K-ohm variable 
resistor connected to +5V. 



15, 14, 13, 12 



9, 16 



GHD 


Systern graiind, 


ftN0-AH3 


Annunciators. These are 




standard 74LS TTL outputs 




and must be buffered to 




drive other than TTL inputs. 


n. c. 


Nothing is conn&cted to 




these pins. 



a 

a 

a 
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Expanding the Apple lie 

The main circuit board of the Apple He has eight empty card 
connectors or slots on it. These slots make it possible to add 
features to the Apple lie by plugging in peripheral cards with 
addilional hardware. Chapter 6 descnbes the standards for 
programming peripheral cards tor the Apple lie. This section 
describes the hardware that supports them, including all of the 
signals available on the expansion slots. 

The Expansion Slots 

The seven connectors iined up across the back part of the 
Apple Ne's main circuit board are the expansion slots, afso called 
peripheral slots or simply slots, numbered from 1 to 7. They are 
50-pin PC-card edge connectors with pins on 0. 10-inch centers. 
A PC card plugged into one of these connectors has access to 
all of the signals necessary to perform input and output and to 
execute programs in RAM or ROM on the card. These signals 
are described briefly in Tables 7-19a, 7-19b, and 7-f9c. The 
following paragraphs describe the signals in general and mention 
a few points that are often overlooked. For further details, refer 
to the schematic dtagram in Figures 7-14a, 7-14b, 7-140, and 7-14d. 



The Peripher&i Address Bus 

The 6502's address bus is buffered by two 74LS244 octal three- 
state buffers. These buffers, along with a buffer in the 6502 s 
R/W line, are enabled by a signai derived from the DMA' daisy- 
chain on the expansion slots. Pulling the peripheral line Dl^A' low 
disables the address and R/ui' buffers so that penpheral Df^A 
circuitry can control the address bus The DfyJA address and 
R/W signals supplied by a accessory card must be stable all 
during t^o of the instruction cycle, as shown in Figure 7-13. 

Another signal that can be used to disable normal operation of 
the Apple lie is inh'. Pulling ihh' iow disables all of the memory 
in the Apple lie except the part in the I/O space from fcooo to 
ICFFF. A penpheral card that uses either INH' or DMA' must 
observe proper timing; in order to disa&le RAM and ROM cleanly, 
the disabling signat must be stabie all during 4io of the instruction 
cycle (refer to fhe timing diagram in Figure 7-13). 

The penpheral devices should use I/D SELECT' and 
DEVICE SELECT' as snabjes. Most peripheral ICs require their 
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Each daisy chain works ifke this: the output from each connector 
goes to the input of the next higher numbered one> For these 
signals to be useful for cards in lower numbered connectors, all 
of the higher numbered connectors must have cards in them, and 
all of those cards must connect DMA IN to DMA out and INT IN to INT 
OUT, Whenever an accessory card uses pin DMft' , it must do so 



i 



enable signals to be present tor a certain length of time before 
data is strobed into or out of the device. Remember that I/O 
SELECT' and DEVICE SELECT' are Only asserted during ffro high. 

The Peripheral Data Bus | 

The Appie lie has two versions of the 6502 data bus: an internal m^ ^ 

bus, MDO MD7, connected directly to the 6502; and an external bus, 1 

D0-D7, driven by a 74LS245 octal bidirectional bus buffer. The r^^m 

6502 is fabricated with MOS circuitry, so it can drive capacitive 
loads of up to about 130 pF. If peripheral cards are installed in 
all seven slots, the loading on the data bus can be as high as 
500 pF. so the 74LS245 drives the data bus for the peripheral t^ 

cards. The same argument applies if you use MOS devices on 
peripheral cards: they don't have enough drive for the fully- 
loaded bus, so you should add buffers. 



Loading and Driving Rules 

Tables 7 19a. 7 1 9b. and 7-1 9c show the drive requirements and 
loading limits for each pin on the expansion slots. The address 
bus, the data bus. and the R/W line should be driven by three- 
state buffers Remember that there is considerable distributed 
capacitance on these busses and that you should plan on 
tolerating the added ioad of up to six additional peripheral cards, 
MOS devices such as PlAs and ACIAs cannot switch such heavy 
capacltive loads. Connecting such devices directly to the bus will 
lead to possible timing and level errors. 

interrupt and DMA Daisy Chains 

The interrupt requests (IRa' and nmi ') and the direct-memory ^ ^ 

access (di^p') signal are available at all seven expansion slots. A J 

peripheral card requests an interrupt or a Drift transfer by pufling L^^^ 

the appropriate output line low (active). If two peripheral cards 
request an inlerrupt or a DKA transfer at the same time, they will 
contend for the data and address busses. To prevent this, two 
pairs of pins on each connector are wired as a priority daisy 
chain. The daisy-chain pins lor interrupts are INT IN and IHT DUT, 
and the pins tor DhA are DMi^ in and dmp out, as shown for J 1-J7 in 
Figure 7-1 4d. 
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only if its DMft IN line is active, and it must disable its DMA GUT line 
wiiile it is using DMA ' . The I NT [ H and I NT OUT lines must be used 
the same way: enable the card's interrupt circuits with ml in, and 
disable IMT auT whenever IRQ' or Nn] ' is being used. 



Figure 7-13 PeripheraUsignat Timing 




ADDRESS v^ 

JA0-A15. H/W' L X . 
MNH'. DMA- 



PEnPPHERAL SELECT 
I/O SELECT' J 
I^EViCE SELECT > 
i/O STROBE \ 
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Table 7-19a Expansinn Slot Signals 
•Loading limits are for each card 



I 
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^ 1 






V 


J 


Pin Number 


Nam« 


Descrlptian 


E^ 


1 


I/O SELECT Mormally high: goea low during tfrO when the 6502 


3 

3 






addresses focalion tCnXX, where n is. Ihe 






connector number. This line car drive 10 LS TTL 






loads, ' 


2-17 


fl0-ft15 


Three -state address bus, The actdress becomes 








valid during r>i ard remains valid dunng fJiO. Each 


■* 1 






addrsss iine ean drive 5 LS TTL laafds- '' 


J 


18 


R/U' 


Three-stale read/write line- Valid at Jhe same time 


^ 1 






as the address bus; high during a read cycle, low 






during a write cycle. It car> drive 2 LS TTL loads/ 


J 


19 


SYNC' 


Composite horizontal and verticaisync, on 
expansion slot 7 ONLY. This line can drive 2 LS 

TTL loads," 


^ 


20 


l/D 


Normaiiy higti; goes low during ijO when the 6502 


^ 




STROBE' 


addresses a location between tCSOO and 

iCfFF, ThFsJine can drive 4 LSTTL loads. 


-^^ 


21 


HDY 


Input 10 the 6502. Pulling this line lovy during ^b^ 
halts the 6502 with the address bus holding the 
address o\ the iocation currently being fetched 


^ 






This iine has a 3300 ohm pullup resistor to -i-5V. 


^— 


22 


tmA' 


InpLil to ttie address bus buffers. Pulling this line 








low during ^i discornecls the 6502 from Ihe 






address bus. This line has a 330Q ohm pullup 


^ 






rsstslor to -i-5V 


23 


INT OUT 


Irlerrupl prioritv daisy-chain output Usually 
connected to pin 28 (INT IM). 
<Nole: on slot 7 O^LY, this pin car be connected 
to the graphics-mode signal GR; see leKl for 

details.} 


^ 


24 


DMA DUT 


DMA priority daisy-chain output, Usually 
connected to pin 22 (DMA I N). 




2S 


+£y 


-i-5-voH power supply. A toial of 5O0mA Is 
available for all accessory cards. 


Q 


26 


OND 


System common ground- 


e: 
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Table 7-1 gb Expansion SIdI Signals, 








Pin Number 


Name 


Description 


1=^ 


continued 

"Loading limits are for each cafd. 


27 


DPlfl IN 


DMA priority daisy-chain input. Usjally connected 
lopin24 (DMAQUT). 


B 




28 


INT IH 


Interrupt piriorily daisy-chain input. Usually 

connected to pin 23 ( 1 NT DUT }. 


^ i 




29 


Hni' 


Non-maskable inlefrupt to 6502. Pjlling inis line 
low stais an mlerrupt cycle with the 
interrupt- handling routine at location i03FB. This 
line has a 3300 ohm pullup resistor to + 5V. 


^ i 




30 


IRQ' 


Inlernjpt request lo 6502. Pj^ling this Ime low 
starts an interrupt cycle only if the 
Interrupt-dJsable (1) flag »n the 6502 is not set_ 
Uses the irternjpt-handhng rouline at location 
» D3FE . This tine has a 3300 ohm pullup resistor 
to +5V. 


■ 




31 


RES' 


Pulling this line low initiates a rese! rouline. as 
eJescfibed in Chapter 4. 


■ 




32 


INH' 


Pulling this line low during i^l inhibits (disables) 
the memory on the main circuit board- This line 
has a330Q ohm pullup resislor to -h5V 


^^M 




33 


-12V 


- 1 2 volt power supply. A total of aOOmA is 
availabte lor atli accessory cards. 


^E ^ 




34 


-5V 


-5 vDit [Mwer supply- A iotai of 200mA is 
available lor all accessory cards. 


E-i 




35 


3.5©n 


3.58 MHz color relerence signal, on slot 7 otily. 
This line can drive 2 LS TTL loads,* 


p ^ 




36 


7M 


System 7 MHz clock. This dne can drive 2 LS TTL 
loads ■ 


p " 




37 


Q3 


Syslem 2 MHz asymmetrical clock- Ttiis line can 
drive 2 LS TTL loads." 


E 




38 


*1 


6502 phase 1 clock. This line can drive 2 LS TTL 
loads. * 


^^^ — 










^S '* 










H^ -* 










^m~ - 
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Table 7-19c Expansion S?ol Signals. 
continued 

^Loading limits am for each card- 



Pin Number 



Name 



Desciiplion 



39 



40 



41 



42^3 



SO 



^PSYNC 



The 6502 signals an operand fetch by driving Ihis 
line high during Ibe frrst read cycle of each 

instruction. 



6502 phase clock. This I 

loads, ' 



iriBeandriveaLSTTL 



DEVICE 

SELECT' 



D0-D7 



-\2\/ 



Normally high; goes low during <iQ when the 6502 
addresses localion *COti)(, where n is the 
connector number plus 8. This line can drive 10 
LSTTL toads." 

Three-state buffered bi-directional data bus. Data 
hecomes valid during jM* high and remains valid 
untail 4^Q goes low. Each data line can drive one L$ 
TTLload." 

+ 12 voll power supply. A total ot 250mA is 
available for all accessory cards. 



Video Signals on Slot 7 

The video signals are available only on the auxiliary slot and not 
on the numbered expansion slots, except for slot 7. The video 
signals avatlable on expansion slot 7 are SVNC ' , the composite 
horizontal and video sync signal, on pin 19, and 3.5QM, the color 
reference signal, on pin 35. Early production Apple lies, identified 
by a circuit board part number ending in -A, do not have this 
feature. 

The signal that enables the graphics modes, named gr, is not 
normafly available on the numbered expansion slots. Yoti can make 
it auailabfe on pjn 23 of slot 7 by completing the circuit al location 
X7 on the main circuit board. Remember lo turn off the power 
before changing anything inside the Apple Me. Also remember that 
changes siach a$ this are at your own risk and may void the 
wan-anly. 
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The Auxifiary Stot 

The large connector at the left side of the Apple lie's main circuit 
board is the auxiliary slot. It is a 60-pin PC-card edge connector 
with pins on 0.10-inch centers. A PC card plugged into this 
connector has access to all of the signals used in producing 
the video display. These signals are described briefly in Tables 
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7-20a, 7-20b. and 7'20c. For further details, refer to thie 
schematfc diagram in Figures 7- 14a, 7-1 4b. 7-1 4c, and 7-1 4d, 

Many of ttie interna! signals that are not available on the 
expansion slots are on the auxiliary sbt. By using both kinds of 
connectors, manufacturing and repair personnel can gain access 
to most of the signals needed for diagnosing problems in the 
Apple lle^ 

80-coiumn Display Sigrtat^ 

The additional memory needed for producing an 80-column text 
display is on the SO-coiumn text card, along with the buffers that 
transfer the data to the video data bus, as described above in 
the section Text Displays '. The signals that control Ihe 80- 
column text data include the system clocks t^o and t£fl , the 
multiplexed RAM address RA0-R^7. the RAM address-strobe 
signals pras* and pcaS', and the auxiliary-RAM enable signals, 
ENSQ' and R/W80. The EN80' enable signal Is controlled by the 
80STDRE soft switch described in Chapter 4. Data is sent to the 
auxiliary memory via the internal data bus MD0-riD7; the data is 
transferred to the video generator via the video data bus VIDO^ 
VID7. 
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^^^^^^^^^H 


^^^^1 


^^B 


^^^^^H^^^^mi 








Table 7-20a Auxiliary Slot Signals 












Pin Numtwr 


Name 


Description 




1 


3.5SM 


3.58 MHz video color reteirence signal. This line 












car drive two LS TTL toads. 








2 


VID7M 


Clocks the ytdao dots out of \he 74166 












pafallel-lo-sersal shift register. This line can drive 


^ 












two LS TTL loads- 


^ 








3 


SVKC 


Video honzontal and vertical sync signal. This line 
can drive mo LS TTL loads- 


u 








4 


PR AS 


Multiplexed RAM row-address sirobe. This line 


I 












can drive Iwo LS TTL loads^ 








S 


VC 


Third low-order vertical-counter bit. This lire can 












dnve two LS TTL loads. 


^ 1 








6 


C07X' 


Hand-control reset signal. This line can drive two 

LS TTL loads. 


H 








7 

a 


UNDM' 

SEGA 


Video non-biarik window. This line can drive two 
LS TTL loads. 

First Eow-order vertical counter tiil. This linB can 
drive two LS TTL bads. 


d 








51. 10, 49. 






r 1 








48. 13, 14, 
46.9 


ftAE-RA? 


Multiplexed RAM-ad-dress bus. This line can drive 














two LS TTL loads. 








11, 12 


RQMENI, 


Enable signals for the ROMs or the main circuit 












HUMENS 


board'. 








IS 


R/N 


Read/write signal from 6502. This line can drive 
two LS TTL loads. 


L J 








44, 43. 40, 






^ 








39, 21,20, 






ur^ 








17, 16 


MD0-MD7 


Internal (tinbuffered) data bjs. This line can drive 
two LS TTL loads, 


e: 




[ 
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^^^^^ 


^1 


■ 


^B 


^^^^1 


^^^^^^^^^^^^^^^^^B 






















^^^^^ Tabre 7-?0b Auxiliary SJot Signals. 

BE^~^ cofilinued 


Pin Nluniber 


Name 


Description 












E 


45. 

3S. 

16. 


42, 
£2. 
15 


41. 
19. 


VID0-V1D7 


Video data bus This Ihtee-staJe bus carries video 
data 10 ihe character generator. 


t 


23 






<60 


6502 Clock ]3ha&e 0, TDIs line can drive two LS 

TTL ioads. 


E 


24 






CLRGAT' 


Color-burst gating signal. This line can drive two 
LS TTL bads, 


r 


25 






80WID 


Enables eO-calumn display timing. This line can 
drive two LS TTL loads. 


g-y 


26 






EMSO 


Enablo For auxiliary RAM. This line can drive two 
LS TTL loads. 


B=^ 


27 






ALTWID' 


Alternative video output to the video summing 
amplifier- 


ts 


2S 






SERQUT- 


Video serial output from 74166 paralleMo-seriai 
shift rogister. 


E 


29 






ENVID' 


NormaKy low; driving this line high disables the 
characlor generator such that the video dots from 
the shift register are all high (white), arid 
artornative video can be sent out via flLTVtD'. 
This line has a 1000 ohm pulldown resistor to 
gjound- 


■^ 


30 






+S 


+5 volt power supply- 


H^ 


31 






GND 


System common ground. 


tl 


32 






14M 


14.S MHz master clock signal. This line can drive 
two LS TTL toads. 


B=5 


33 






PCA5 


Multiplexed column-eddress strobe. This line can 
drive two LS TTL loads. 


c 


34 






LDPB' 


Strobe lo video parallel to-serial shift register. This 
signal goes low to load the contents of the video 
data bus into the shift register. This line can drive 
two LS TTL loads. 


1 
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Pin Number 


Name 


Description 


J 


continued 








!HS 




35 


evujao 


Read/wrile signal lor RAM on Ihe 80-column lent 


J 








eafd. TtiiB line can drive two LS TTL loads. 




3e 


*1 


5502 clQck phase 1. This line can drive two LS 


L ■ 

J 








TTL loads, 




37 


CASEN' 


Column-address enable. This signal is disabled 
(held high) d jTing accesses to memory on the 
auitiliary card, Ttiis line can drive two LS TTL 
loads. 


J 




47 


HO 


Low-ordef horizontal byte countar- This line car 
drive two LS TTL loads. 


^ 




50 


AN3 


OutpjT Of annunciator number 3. This line can 
drive two LS TTL loads. 


M 




62 


«/u 


6503 read/write signal. This line can drive two LS 
TTL loads. 


d 




53 


Q3 


2 MHz asymmetrical clock. This line can drive two 


J 








LS TTL loads. 




54 


SEGB 


Second low-order vertical-counter bst. This line 
can drive two LS TTL loads. 


J 




55 


EMFIRM 


Normally high; pulling this line tow 


n 








disables Rnni and ROn^ on the main circuit 








board. This line has a 3300-Dhm pullup resistor to 








+SV. 


U^ 




56.57 


RA9', RAtO' 


CharaclBT-generalor control signals trom the lOU, 


J 








This line can drive two LS TTL loads. 




5S 


GR 


Graphics-mode enable signal- This line can drive 








two LS TTL loads. 




59 


7M 


7 WHz timing signal. This line can drive two LS 






€0 


ENTMG 


TTL loads. 

NormaHy low: pulling this line high disables the 


J 








master timing from the PAL. This liine has a 10QO 

Ohm pulldown resistor to gfound. 


3 
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Appendix A 



The 6502 Instruction Set 



The FoUowIng Notation Applies to This 
Summary: 



X ¥ 

M 

C 

P 

s 



* 



V 

PC 

PCH 

PC4. 

DPER 

> 



lnd».r HegislBrS 

Memory 

Borrow 

protessOF Sl*1ui ReBialer 

Biflrk Pomtftr 

No Ch»ng* 

LagiCHi AND 

Logical EiClLJSii'e Qr 
Triftifftf Ffiort Ir-i^ack 
TtBnsfer Tc3 StitK 
Transfer To 
Trtnjfef To 
LogiCKl OR 
Progiram CaUifltftr 
Program Courier HiflU 
Pro^fSm Counter Ld-a 

Immadiale Ad>i]r#»irig MS4e 



FIGURE 1 A5L-5MIFT LEFT OmE B^T OPERATION 



S ^ 



3 £ 



-^-l I 



FPGURE a ROTATE ONE BIT LEFT ,;MEMORv 
on ACCUMULATOB) 



^ 



M OR A 



i 4 



ZJ^ 



FIGURE a ROTATE ONE BIT RIGHT {MEMORV 
ORACGUWLrUTOR) 



C 



WOTE 1 BIT - TEST BITS 

Qil S inQ T are Iranslerred to IPia SiAtuft rsguter II Iho 
fflSuH of A A )^ i» ler^ than i-^ , at^^sTW^S* 2=0 
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6502 Microprocessor tnsiructions 



ADC Afffl MemoTv id ftc c um u-fal d' wilh 

AND "AND Mcrfiiory «rin Acc^muialar 

ASL SMi'H Lett Ori« Bif iWKr»ieiri|i or 

BCC Br»rich Of* C»'f)t Cl««f 

aCS Branth of- Ci'fy S-fl 

BEO Branch af Resull Ztre 

BIT I'^St P'lls II Memory wi^h 

ACCumwHtOF 

BMI Srancn on RcjuH Minus 

BtlE flrantH o" RtiwH no! Z«iro 

OPL Branc*! on Rb-suII Pius- 

BVC Branch b/i Ov^HIb* Clftir 

BVS Branch on Ovflrllci'?" &S( 

CLC CiDiir Carry Flag 

■CLD Cltar D*tii*i*l Mpde 

CLI Clear InlerruC?! Disable 6it 

CLV Cl«»i' OverfliDw Flag. 

CMP Coi^Da'f Memo'"^ and AccumulaLar 

CPX Compare Me^^^^^y jno ina«« » 

CPy Compare Memory and Iredfli Y 

DEC Deciemienl Mtmory by Qr>t 

DEX Ot-C-'sm^n': Index X. by Qne 

DEV DotiEmshi lnde« "f &v One 

EO'H "EKCPusi^a-Dr " MHmfiry witn 
AcCufTiumor 

iNC IntrerrtsM Wtmo'> 6y One 

INX incrBmenl InnJe™ J< by One 

INV incemerif inrdei* V by One 

JMP Ju^ip ta Mt" L0t*1iOn 
^clurr Address 



LDA Load ^ccbimLjitlor »wriri Memary 

LDX Load Indei X wiiri Msmfirv 

LDV Load Inden Y wil*i Memorv 

L5I1 Shilr RtghE one Bd 'Msmpry or 

NOP No 0{}Graeio<T 

ORA "OR' Mrmory Hiitin Acturnulatar 

PHA Pusri flCcLjrfiulitor on Sl*cii 

PHP Push Practssar Stains On SfStli 

PLA Pull Accu^mulator from Slac:4i 

PLP Pull PJ6C*«or SlUwi ffom 5«cl( 

nOL noCAl? One BiE LeTl 'W«fTtQ<> Qf 

AccumtrlBtori 

flOR Flci-tAi* Ont Sif RiffPif 'Meino'y Pf 

Accijmijlateir' 

BTI Helurn liom Interrupt 

RT& Rtlurn Irom ButirouiinF 

SBC Subtract Memory fram Accum'UlaiDr 

SEC Set Car[7 Flag 

SEP Sft pieomai Mode 

SE( Ser inveri'uDf DuaDie Siarua 

STA Siare Accummalor in Memory 

STM Slara Inde* X in Memary 

STT SlOf* JrHj*ii ¥ in Memory 

TAK Transfer ACCurrulitor \o lnd#ai X 

Tat Transtar Accumulsrar id (f*a*jc T 

T5X Tffnster ^lacnt Ppml^r lo liriclflx X 

TXA transtcr Indri X lo AccurrulBiJor 

TKS Transler Indti It lO SlJCh Poin1«r 

TVA Transfer indec V lo Accurnuislo" 



I 

i 
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11 

a 

a 

i 

a 
"J 

J 



Programming Model 



^ 









^ 


7 




a 


X 



ACCUWULATOH 



INiDEX REGISTER V 



TNDEX REGISTER X 



15 



PCH 



PCL 



PfllOGRAM COUNTER 



STACK POINTER 



N ^ I B Dj 



PROCESSOR STATUS REGISTER "P 



— CARRY 
-2EFIO 

— INIERRUP" DISABLE 

— DECIMAL MODE 

— BREAK COMMAND 

— OVERFLOW 

— hlEGATIi^E 
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Instruction Codes 



I 

I 



Nirtii 
□iKrlpunn 


OpiriNciH 


AdtfreLiini 


AtiEfntili 
Liifluigi 


HEX 

DP 
CsAe 


No 
Bylei 


— 
"P" Sniiii lliD 

N Jt 1 g V 


ADC 

Aaa mtmory Hj 
atcumuFatQi wild carrv 


A-M-C -"At 


Imrnrdiale 
Zera Pagf 
;eia Page 1^ 
AbsQluif 

Ab^DUtP X 
AbMlul* V 
linriirttl.Xl 
(rndirpcll V 


AQC 'Op{r 
ADC OptE 

APC Optf.X 
ADC Opcr 
ABC DccJ.X 
AK Op«r tf 
ADC rOuer X] 
AOC tOcen ¥ 


SD 
7D 

61 
71 


2 

3 
2 


^ \ % - - 1. 


AMD 

"AND" meffiory tfiin 
acjcumulitor 


AAM —A 


ImiTiedi.iie 
Zfro P*ge 
^Ern PjgE.X 
ACi^Gbte 
Ab^plult X 
Absolitiie V 
fln<iirBtl.;f| 
iinfliffEM.V 


AND »Ocei 
AND Opfr 
AKP Dp«i.X 
AND OcKr 
AMD Ci[»Er X 
AMD Oper.y 
AND jgpei XI 
A NO lOperl y 


29 

3D 
31 


5 

3 

3 
3 

2 


\ ■» 


KSL 

Shift Icti ont bil 
iMemciry q« Accumu'irprl 


(See Figure 1| 


Accumuliiwr 
Zero Page 
Zero PigeX 

ADSPJUtP 

AbEDiufe's 


ASL A 
ASL Ope' 
A$l|. Dpcf.K 
ASL Dpei 
ASl Op«iX 


DA 
QG 
16 
DE 
IE 


\ 
2 

2 

3 
3 


V^'i' 


BCC 

Bfancr gn carry clfai 


flrincl on C-fl 


Rtl alive 


BCC Offfr 


W 


; 


_ 


BCS 


Biancti on C* 1 


Fletalive 


ESCS Oper 


BO 


2 




m 

Branch gn rt&tiEt letlt 


Brinth pn ^- ] 


RtlSt'^f 


SEC OfKi 


FO 


? 




BIT 

Test bJia m memory 


A^ U M^ 'N. 


Zero Pggi 
AbifrluliE 


aiTi Ope' 
9IT'< Dper 






Mr-.' -Mfi 


BMI 

Branch on rEaull miiilLS 


Etrani^h pn H- 1 


Rdafiy* 


BMI (hper 


3D 


2 


. - 


BNE 

Bfincti an rfiuH niQl zero 


Biinch pn I- Q 


Rcldtfe 


BN£ DD«f 


[» 


2 




BPL 

Branch pn I»ul1 plus 


Branch ftn N'ffl 


Rel^live 


BPL npe' 


ID 


? 


. 


BRK 

tuiit Break 


F&rccd 
Inlef'uol 
PC'! t P * 


Implied 


SBk2 


00 


1 


...,__ 


BVC 


6r3.nc^ an V D 


Rfiain^e 


BVC 04]er 


U 


? 





i 



Nola 1 : Bils 6 and 7 arE translerrso XO ihe sLaius regislar. If Ihe result of A AtJD M is zero. 

I hen Z = i: olherwise ? ■■ 0- 

N ale 2, A BRK command cannQl be mosked by Mtlirtg I, 
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Hirnt 
Dueilpitnn 


OplJltliin 


Add^'fliiiif 
WodE 


HiiFPibty 

LinQuift 

Ffriii 


ME) 

Cvita 


h« 


1" Sniui. nm 
H J c: 1 n u 


B'ancn on i^vfuio* set 


Brancfi on V-' 


Fie>aii^F 


6V5 Dpfi 


7n 


-, 




CLC 

ClF3r carry flag 


0— C 


imoliid 


CLC 


1S 




-■-□-- 


CLD 

Clf-ar dfnrr.al moBs 


0— t 


Implied 


CLB 


D£ 




-n 


CLI 


C- —1 


inpi ed 


Ctl 


^ 




— 0-- 


CLV 


f; *v 


iTiDied 


CLV 


Be 




D 


CMP 

Compare mrmory and 
JccunnyrsitQI 


A - M 


Imrrediale 
let a ^iit 
Ztrp PjB< >< 

ikdEDtuie-.^c 

iMdireci Kl 
llnjirfcii t 


CMP «aii-er 
CMP Op(f 
CMP Cp(» K 
CMP Ope< 
CMP Opif K 
CMP Opt' V 
CMP iCJDcrXl 
CMP iCJperi i 


eg 

CD 
DO 


2 

3 
3 
3 
? 


\\'\ 


CPJt 

Cumparf nvemary and 


X - M 


rmJTied-arf 
7erp Pagt 


CPI lOper 
CPX OjHr 
CPK Omf 


E4 
EC 


2 

3 


V \. \ 


CPT 

Camjjare mtmary and 
inflw r 


V- M 


imned-ait 
AQsaiult 


CPV .JpfT 

CPY Opcr 
CPY Oner 


CO 

cc 


2 
2 

3 


V ^ ^' 


DEC 


M - 1 — M 


Zerp PjQ« 
Zerp PageX 
AQ^ttlul'E 
ADSthluU.X 


DEC Qoer 
Die Qtwr.X 
GfC 0[>er 
DEC Opei.Jt 


06 

CE 
DE 


2 

3 
3 


v' v' " 


Cn ■one 


K - 1 — K 


ifnjsiieff 


D£X 


C4 


T 


V V 


Dj onr 


V 1 -y 


lmj>lie{f 


DfY 


sa 


1 


■m v'- - - - 
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Himi 
Ducrkptlan 


Qprntllfl 


Ailitriuint 


L»rtBiii(i 
Fii'H 


HER 
IIP 


No 

BflU 


r SliEui Rii 

NZCI D V 


EOR 


AVM -A 


liTimefliaH 
Zera Page 
ZEtQ P^geX 
AbsotuiB 
Ab^DtulC X 
AMQiurf 1 
tln(tirfi(l,X| 
ilndiriCtl V 


EOR Oper 
EOR Op» X 

EDR Opei- 
EOR Opct.K 
tOR fflpet y 
tOB fOpsr.Xi 
EOn iQpcM V 


49 

55 
4fl 

59 

St 


2 

3 
3 
2 
3 


v'v' 


INC 

mcieneni memory 
by one 


H -^ 1 — M 


Zero Pagf.x 
Abi«lLle 

AlhSDtUlC.'X 


INC Opcr 
INC OiKi.i 
INC flptr 
hNC Oper.K 


F6 
EE 


2 

3 
3 


V ^' " 


INX 


X - 1 —X 


1 m pl>nl 


1KX 


ES 


1 


V'v ■ ■■ ■ 


INY 

inC'Efflieni iriej v bv orrnr 


y ' 1 —V 


(mphed 


INY 


CB 


1 


■^'V 


JMP 

Jump (0 ne« Ipcaiinn' 


fPC'ti — PCl 


Assoiyi* 
Indicecl 


JMP Oper 
JMP lQp<rl 


4C 
6C 


3 

3 




JSR 

Jump \a r<w lOCdtton 
saving fclu'i' iddress 


PC-SK 

|.PC-1) ^PCL 
IPC'J'i —PCH 


AQsalulc 


JSn Cj)er 


20 


3 


.. . -- 


IDA 

Load 3C'Cii>*i'iilal'Dr 


M -*fi 


Ini'tMdiStf 
Irta PdQC 
Zero P^gtJt 
Ab&DlulE 
AbsDture.X 
AbspluEt Y 
llndHrtct.Xf 
>|ln[]ireir[:i Y 


LDA mflper 
IDA Q[Kr 
LDA OpsT.X 
LDA 0(Ui 
LDA OiJSr.)! 
LDA Op^r K 
LBA |Op«(.Kl 
LDA iDoc'J.Y 


A9 
AS 
BS 

AD 
BD 
fl9 

A1 
B1 


2 
2 

? 
3 
3 

a 

2 
2 


^/^/ 


Laaef in-dct X 
Wilh mfnujrT 


M —X 


lirmvedFjlE 
ipa Pjge 
Jefft Page Y 

AEnSDluEf Y 


LAJf nOcier 
LDX Oppf 
LDX OperY 

l&X Osier 
LClX OperY 


A2 

BG 
AE 

BE 


3 
2 
2 

3 


vV -- 


LQY 

Lnifl ifme- Y 


M ^r 


Zero Page 
let a Page )l 

Ab%oiu[B X 


iVt OpcrX 

tfflV Oper 


.AC 
DC 


I 

2 
3 
3 


J, ■ 
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i 

i ■ 

"J 

3 

Li 

li 

U 
J 

J 



Ninr 

QiicrlDlkM 


DFcrilliDn 


Ail||riuin| 


Jllllfftflir 

LiAguigii' 

Ftrpi 


DP 
CtlH 


Hi 

Brill 


~r SiEiu Mil 
NfClflV 




IStr Figure III 


Accu mu lalor 
Z«rc PaQt 
Ztre Pag*,)! 
Absoiule 
AbsalulB X 


Lsn A 

LSR Opsf 
L&H Dper.): 
L5R Oper 
LSFL Opet >; 


4A 

» 
IE 


1 

2 
3 
3 


D^V - 


NOP 

ha QpiTjimn 


Na <)prra[rcj) 


tmpliid 


NOP 


EA 


1 




ORA 

"OH" memorji wilh 


A V Eri -- A 


Irnmcilii.Ee 
2ttc Page 
Zero PdQc.K 
Absalule 
Absalult.K 
Abschlule.y 
4tndtrea X| 
(>nOtreci|,Y 


ORA «0|]E* 

□RA Dper 
ORA Oper.X 
DRA Qp«r 
ORA Oper.X 
QRA Dp^r.y 
ORA lOpB! XI 
ORA [Qperj.r 


IB 
06 
K 
00 
1D 
19 
Of 
It 


Z 
2 
2 
3 
3 
3 
Z 
2 


^v' 


PHA 


M 


Impliea 


PHA 


4a 


1 





PHP 

Push pioctiiin £talu$ 
on stick 


p * 


IfFpllBd 


PHP 


n 


1 




PU 

l^■ll jiCumullEor 
ham stack 


At 


ilmpltrd 


PLA 


« 


1 


^^ 


PtP 

Pull pioLc^ior ^tiatu; 
front Slack 


Pt 


ilmpliied 


PLP 


» 


1 


From StAck 


ROL 

RQiai« pnv tMl Ipll 
(rnemofv oi Accumulal^r) 


|Sf « Figure Z) 


Accumulaictr 
lira Pagft 
Zero P^gp.K 
AQjQiijEe 
Absfilute.X 


HOL A 
ROL Op*r 

HOL Op*r.K 
HOL Cp*r 
ROL Optr.X 


ZA 


1 
2 
2 

3 


v/^V 


RQR 

imcmory or dccufnulaivrl 


iStf Figufe 3) 


AtCumulalor 
2eta f^agt 
Zero PaQe.X 
Absolute 
Absalutc.X 


HOR A 
ROFl Dper 
HGR Dper X 
HOR Oper 
ROFL Dper.); 


GA 
56 


1 
? 
? 
3 
3 


VVv'--- 



Instruction Codes 



Nimi 

Deter If Hen 


Qpirjiwn 


IdrireiiliiD 
Mnat 


AiiemblT 

Form 


HEX 
OP 

Cell 


Mb 


"r SLitui hg 
KZU 1 V 


HTt 

nelurii UfTT' inlrrtupl 


PtPC* 


Implira 


RTI 


40 


1 


Frpm Siacii 


RTS 

Return Irom subrculinE 


PC* PC-1 —PC 


Implied 


R15 


60 


1 




sac 

actum lI Hint Wim tlDir»«f 


A M C— A 


IrametfiBifl 
Ztii Pa^t 
Zei« Pi{|e X 

AbSQlulc X 
AtisDlul« V 
ilimaifecvXl 
Ortdiredi ■H 


5BC dOp£l 

SBC Oper 
SBC Qpcr X 
SBC Oper 
sac OperS 
SBC Ope^f 
SBC fOper Jl 
EBC iDperl.V 


E9 
F5 

FO 

FS' 

FT 


2 
2 
2 

i 

3 


W*. V 


SEC 

Sti carry 1Ug 


1 — C 


ImpliEd 


£EG 


38 


1 


- - 1 - - 


SED 

S<1 deDmar mpdc 


1 — D 


Fmjfiieiti 


SED 


F8 


1 


,- 


SEI 

S(l interruftr disable 


1 ^1 


rmDiieif 


SEI 


ra 


1 


1 - - 


STA 

Slare accumul^tar 
in memioi'^ 


A—M 


Zero Pag* 
Itia Pigt H 
Abspiule 

Absolul-e.V 
1lr»dipec:l.Il 
^ftdirecn V 


ETA Oper 
STA Opet X 
STA Qpiw 
STA QperX 
STA Opet V 
S1A fOpflNXI' 
STA lOperl.f 


B5 
95 
SO 

B1 
91 


2 
t 
i 
i 

3: 
2 
2 


" 


STX 

Stofc ifidtr X in immorjf 


K -hM 


Zero PiB« 
Itio Pag* Y 
ADsalulc 


STX Oper 
STX Dper.'r 
STJf Offer 


as 


2 
2 
3 




STY 


V — M 


Zero Pagf 
^erfl Pafle.X 
Absolute 


STV Offer 
£T^ Dper.X 
STV Oper 


8C 


5 




T«X 

Traniki accumuFatot 


ft-^X 


Implied 


tAX 


AA 


1 


Y > ■ 


T«Y 

TransliPT scruTiwIalpr 
Id ifldes. V 


A — .Y 


Implipd 


TAV 


AB 


t 


vV 


TSI 

fransld ElaC" pcmler 
Ig index X 


S —X 


Imp'liBd 


TSX 


fiA 


1 


^ •.'" ■ — 



a 

'i 

3 
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Nttni 


Gpfri'iDn 


Addresi.lrtQ 


LinquJiM 
Fflrm 


Ha 

OP 
Ctidi 




"P SLi^yi Rig 
H Z £ t D ir 


Transfer indflii K 
111 dCCUinulHIttr 


X —A 


Implied 


IXA 


U 


1 


-.^ 


TKS 

ar^E.k Doinfer 


K -£ 


ImpJied 


TXS 


9ft 


1 





TYA 

to jccumuiamii 


Y —A 


Implffd 


TYA 


*? 


1 


vV 
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1" 






t-; 




Codes 




J 


00 - BHK 


?f - 


5E — LSfl - Absolul*. )( 


^ 


Dl - ORA - HnauBCi Xi 


3Q - BMI 


SF - 


1 


02 - 


31 — AND ^ 'IndirECli V 


60 - RTS 


J 


CO — 


3? - 


61— ADC— lnaif*cr Xi 


JTj 


0* - 


33- 


62 - 


^ 1 


05.— ORA - Zero Paoe^ 


3* - 


aa — 




06 — ASL — Zern PagiB 


35 — AND — Zero Page. M 


54 - 


J 


OT - 


36 — HDL - letit Paige X 


&5 — ADC - Ztro Pige 


. -^m 


06 - PHP 


ar- 


66 - fiOR — Zera P*9# 


%t^^ 


W - DRA - Immadiite 


38 - SEC 


67 - 


^ 1 


OA — ASL — AccufTHjHtor 


39 - ^NO — AhsolulE ¥ 


ee — PLA 




OB- 


3A - 


69 — ADC — ImmeOiBle 


^ 


OC 


3B - 


SA — HOH - ace ym uiaior 


^^ 


OD — ORA - AbS&lule 


3C - 


se - 


OE — ASL - Absolute 


3D - AND - Ab&alule 3< 


EC - JMP — indJtecl 




OF ^ 


3E — ROL - AtiSOiule K 


BO — ADC — Abs&luile 


^ 


ID - BPL 


3F - 


6£ — ROR — AbsoluH* 


Q 


n - ORA - (Ir^Oirecli. V 


40 f^tl 


6F - 


C?^ 


IB - 


41 - EDR — UFidirecl. H 


70 - BVS 




13- 


42 - 


71 — ADC - <lnaifeci», V 


^^ 


M — 

15 — OftA — Zero Ptqe. X 


*3 - 

44 - 


7? - 

tn - 


t- 


16 — ASL — Zkfd PRg«. X 


Jii - EOR — Ztm Pige 


74 - 




ir - 


4i - LSR — Zera Page 


75 - A&C — lurt) Page X 




IB — CLC 


47 — 


?6. - nOR - Z*r0 Page X 


^ 


19 — ORA - AbKOlulBi, V 


4i — PHA 


TT - 


■1A - 


*9— EOH — 'mm»(ii»i« 


?8 - SEI 




IB - 


4A — LSR — AccumulKlDr 


79 - ADC — Abaolula. Y 




■vc - 


*R~ 


TA - 


^B^l 


ID — ORA - AbiolulB X 


*C - JMP — Absolute 


70- 


b- 


IE — ASL — Atjaolure- X 


4D — EOR - Absolute 


7C- 


If - 


4£ — LSfl — AhiOluT* 


7D - ADC — AbfiObuie. » 




M- J5H 


4F - 


TE — nOR — Ab&Qliile X 


^ 


21 - AND — ilndiFKl, xv 


») — BVC 


7F- 


IL^ 


S2 - 


51 — EOn llndireai. V 


BD - 




2i — 


53- 


et — STA — llndirecl, Xi 




24 ^ Bit — Zero Page 


53- 


82 - 




25 - AND — Zero Page 


54 — 


B3 - 


U^ 


ZE — ROL — Zero P»|]b 


S5 — EOR - ZeFD Pige. T- 


&4 —STY - ?w-c P*gB 


i7 - 


£e — LSR — i»Ta Pags- K 


B5 — STA — Ze«0 PtflB 




?a - PLP 

M— AND — InmefliatB 


57 - 
M— CLI 


OB — SIX — Zero Pag* 
B7 - 


^ 


2A — BOL — AccumulMtpr 


S& - EDfl - Abso-lulf. ¥ 


ea - DEv 


2B — 


5A - 


S9 - 




2C — BIT - Ab40ivia 


se - 


SA - TXA 




?D — AND - Ab*dlul« 


iC - 


ae ' 


^ 


?t - ftOL - AbioJule 


5D — EOR -' AOiololP. H 


aC - SIT - A&SQiule 








^ 








e: 








c: 
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aD - 


STA - 


At-i.O''vtt 


a^ - 


lD\ - 


iti't Pjge X 


D8 - 






SE - 


STk - 


ABia-luT* 


a£ - 


LDA 


Ztio Paflf * 


DC - 






Sf - 






B& — 


LDX " 


- 2#((j Ptge V 


DP - 


-CMF 


— AD-Siviurc H 


» - 


HCC 




3- - 






D£ - 


DEC 


- ADSOHJlr X 


91 - 


ST* - 


ijudirect V 


B8 - 


CLV 




OF - 






is - 






B9 - 


LtJA - 


- AhsD'nie T 


EO - 


CPX ■ 


- Imm-Kdiaie 


33 - 






BA - 


TSk 




E-- - 


SBC - 


- llPdlFECl *C 


34 - 


STV - 


Zero PaiJP X 


B0 - 






E? - 






95 - 


&TA - 


■ Z'B'o Page i 


BC - 


■LDV - 


' A>bs:}iute X 


t3 






96 - 


SIX - 


■ Zero Page ^ 


QD - 


■ LDA - 


- i6Ci5C1Ili1P X, 


Ed - 


CPX 


Zpfl' Pagi' 


97 - 






BE - 


lDK - 


Apsaiuip V 


E5 - 


BBC 


- Ze'o Page 


M - 


TVA 




BF - 






E6 - 


INC - 


- Zera Page 


w- 


STA - 


At>»i:iiTj!« V 


CO- 


CP1 - 


- Imrpedia!* 


e: - 






9* - 


TXS 




Ci - 


CMP 


— indirec! X 


ES - 


INK 




9B - 






c^ - 






EB - 


SBC 


- ►miTifrCj4aie 


9C - 






C3 - 






EA 


NOP 




9D - 


STA - 


ADSiCinilv X 


C4 — 


CP> - 


- Zffo Page 


EB 






aE- 






CS - 


CMP 


- £:e'o Page 


EC - 


■ CPx 


- Absmute 


BF- 






ce- 


DEC - 


— Zs'a Page 


ED - 


sec 


- AUiolute 


AO — 


LDv - 


■ imrflBd!*!* 


cr - 






EE - 


<NC - 


- Absolute 


A1 - 


LDA - 


■IndirtCt X' 


Cfl - 


INY 




EF - 






A2 - 


UDJf - 


ImmedialB 


CB — 


CMP ■ 


— Immednie 


FO - 


BEO 




*3 - 






CA - 


-DEX 




^1 - 


sec 


- iirtdjrect . Y 


A4 — 


LDT - 


■ Zero Page 


CB - 






F2 - 






*5 - 


LDA - 


■Zero P*9e 


CC- 


. Cpv - 


- Aftsoiuie 


F3 — 






AC- 


LDX - 


lera fftge 


CD- 


-Ct^P 


AbiolulF 


F4 - 






A7 — 






ce - 


OEC- 


— Absolute 


F5 - 


sac 


- JpfiJ Pag* > 


AB - 


TAY 




CP - 






F6 — 


INC - 


Zero Ptqe. K 


AB — 


LDA - 


' JmmBi]il»1« 


DO - 


bme 




FT — 






AA - 


-TAH 




o% — 


CMP 


— iir>direcli. V 


Ffl - 


SEO 




AS - 






07 - 






F5 - 


sac 


- AtiSDiule V 


AC- 


L0> - 


■ Abi-olyte- 


03 - 






FA - 






AD - 


- Abt'Oiute 


D* - 






FB - 






AE - 


LDK - 


AfisDiure 


D5 - 


CMP 


— zire nga. X 


FC - 






AF — 






D6 - 


- DEC 


- Ziro pag*, X 


f D - 


■ SBC . 


— AdsoIuIib X 


BQ -- 


BCS 




DT - 






FE - 


INC - 


- Ai>st>lLile X 


fit - 


LOA - 


■ 'Indiiecr t 


D8 - 


■ CLD 




FF — 






62 - 






D9 - 


. CMP 


- Ausolgte >■ 








63 - 






DA- 
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J 

"J 
J 



J 

a 



J 



AppendixB 



Tables 



This appendix contains copies of the tables you wilt need to refer 
to a lot, for example, ASCII codes and soft-switch locations. The 
figures all have their original figure numbers so you can refer to 
the retevant sections in the text. 



Table 2'Z KeyOoard Memory 
Locations 



Location 
Hex 



i:>ecimal 



Description 



tCDOD ^31 B2 -1 G38^ Keybaard data and strobe 

(CO I 43168 ' 16388 Any-key-down flag and Clear-strobe swl1ch< 



Tables 
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Tat3le2-3a Keys and ASCII Codes 

Cades are shoi^n here in hexadecimal; 
to find the decimal equivalents, use 
Table 2-4. 



Key 


Normal 


Control 


Shift 


Both 




7F 
D8 
09 


7F 
OS 

09 


7F 

pa 

09 




1 DELETE 1 


7F 


|LEFT-flRRDwJ 


08 


|TflE 1 


09 


[DONN-ARRQNJ 


OA 
OB 
OD 


OA 
OB 
OD 


OA 

OB 
OD 


OA 


1 UP-ARROW 1 


OB 


f RETURN 1 


OD 


1 RIGHT-ARROW i 


15 


16 


15 


1G 


Usol 


IB 


IB 


IB 


1G 


space 


30 


20 


£0 


20 


• f 


27 


27 


22 


22 


,< 


2C 


2C 


3C 


3C 


- 


2D 


2D 


5F 


IF 


. > 


SE 


2E 


3E 


3E 


/7 


2F 


2F 


3F 


3F 


0) 


30 


30 


29 


29 


1! 


31 


31 


21 


21 


2@ 


32 


oa 


40 


00 


a# 


33 


33 


23 


23 


4S 


34 


34 


24 


24 


5% 


35 


35 


25 


25 


^A 


36 


1E 


5£ 


IE 


7t 


37 


37 


26 


26 


8* 


38 


38 


2A 


2A 


9( 


39 


39 


28 


2Q 


; J 


3Q 


38 


3A 


3A 


= + 


3D 


3D 


2B 


2B 


u 


5B 


IB 


7B 


IS 


^l 


5C 


1C 


7C 


1C 
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'i 

J 





^m^ 


Table 2-3b 
continjed 


Keys and ASCII Codes, 












Key 


Normal 


Conlrol 


&hiH 


Both 


^■g 


















Codes are 


shown here 


in hexadecimal; 


J} 


50 


ID 


7D 


ID 




ID lind the decimal equiva-lents, use 




60 


60 


7E 


7E 


^^^^ 


Table 2^A 






A 


61 


01 


A^ 


01 










B 


62 


02 


42 


02 










C 


63 


03 


43 


03 










D 


e4 


04 


44 


04 










E 


65 


05 


45 


05 










F 


66 


06 


46 


OS 










G 


67 


07 


47 


07 










H 


as 


08 


48 


08 


&^ 








1 
J 


eg 

6A 


09 
OA 


49 
4A 


09 
OA 










K 


SB 


OB 


4B 


OB 










L 


6C 


OC 


4C 


OC 


^^H -^ 








M 


6D 


OD 


40 


OD 










N 


6E 


Q£ 


4E 


OE 













6F 


OF 


4F 


OF 


^ ^ 








P 


70 


10 


50 


10 










Q 


71 


11 


51 


11 










R 


72 


12 


52 


12 


^^H ^ 








S 


73 


13 


53 


13 










T 


74 


14 


54 


14 










U 


75 


15 


55 


15 


^^^H -^ 








V 


76 


16 


56 


16 










w 


77 


17 


57 


17 


^^^^^ 








X 


78 


18 


sa 


ia 










Y 


79 


19 


59 


19 










z 


7A 


1A 


SA 


IA 


B^ 








Tabies 








li 
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1 Tabte 2-4 


rhe ASCII Character Set 
















3 


Dec 


Hex 


Char 


D&C 


Hex 


Char 


Dec 


Hex 


Char 


Oec 


Hex 


Char 


3 





00 


NUL 


32 


20 


SP 


G4 


40 


@ 


96 


60 


^ 


^ 


1 


01 


SOH 


33 


21 


1 


65 


41 


A 


97 


61 


a 


J 


2 


02 


SIX 


34 


22 


Fl 


66 


42 


B 


96 


62 


b 


i^ 


3 


03 


ETX 


35 


23 


# 


67 


43 


C 


99 


63 


c 


^ 1 


4 


04 


EOT 


36 


24 


$ 


66 


44 


D 


100 


64 


d 


J 


5 


05 


ENQ 


37 


25 


"■'o 


69 


45 


E 


101 


65 


e 


E^ 


6 


06 


ACK 


38 


26 


& 


70 


4S 


F 


102 


66 


f 


*1 


7 


07 


BEL 


39 


27 


• 


71 


47 


G 


103 


67 


g 


J 


B 


08 


BS 


40 


28 


i 


72 


48 


H 


104 


68 


h 


B 


9 


09 


HT 


41 


29 


) 


73 


49 


1 


105 


69 


i 


cr 


10 


OA 


LP 


42 


2A 


- 


74 


4A 


J 


106 


6A 


j 




1 ^^ 


OB 


VT 


43 


2B 


+ 


75 


4B 


K 


107 


6B 


k 


C^ 


! 12 


OC 


FF 


44 


2C 


H 


76 


4C 


L 


106 


6C 


1 


ftr^ 


1 t3 


OD 


CR 


45 


2D 


- 


77 


4D 


M 


109 


6D 


m 




td 


OE 


SO 


46 


2E 




76 


4E 


N 


110 


6E 


r. 


e:! 


15 


OF 


SI 


47 


2P 


/ 


79 


4F 


O 


111 


6F 







i ^^ 


10 


DLE 


46 


30 





80 


50 


P 


112 


7D 


P' 




17 


11 


0C1 


49 


31 


1 


81 


51 


Q 


113 


71 


q 


P 


18 


12 


DC2 


50 


32 


2 


62 


52 


R 


114 


72 


r 


1 19 


13 


DC3 


51 


33 


3 


83 


53 


S 


115 


73 


s 




20 


14 


DC4 


52 


34 


4 


64 


54 


T 


116 


74 


( 


^-^ 


21 


15 


NAK 


53 


35 


5 


65 


55 


U 


117 


75 


u 


^— 


22 


16 


SVN 


54 


36 


6 


66 


56 


V 


118 


76 


V 




23 


17 


ETB 


55 


37 


7 


87 


57 


w 


T19 


77 


w 


F*iM 


1 

1 24 


\B 


CAN 


56 


38 


8 


88 


58 


X 


120 


7B 


X 


IM 


25 


19 


EM 


57 


39 


9 


89 


59 


Y 


121 


79 


y 




' 26 


1A 


SUB 


56 


3A 




90 


5A 


z 


122 


7A 


z 


^ 


27 


IB 


ESC 


59 


3B 


; 


91 


5B 


1 


123 


7B 


< 


23 


1C 


PS 


60 


3C 


<; 


92 


5C 


\ 


124 


7C 


I 




29 


10 


es 


61 


3D 


- 


93 


5D 


I 


125 


7D 


} 


-^ 


30 


IE 


RS 


62 


3E 


> 


94 


5E 


A. 


12G 


7E 




5r^ 


31 


IF 


US 


63 


3F 


? 


95 


5F 


— 


127 


7F 


D£L 


Err 
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Table 2-6 The Display Character Sets 

Td identity particular ctiafacters and 
values, refer to Tabis 2-4. 



Primary Character Set: Alternate Ctiaracter Set: 

Hex Values Character Type Format Character Type Formal 



S00-S1 F 
S20-$3F 

$40-$5F 
S60-$7F 

seo-$9F 

$AO-SBF 

$CO-SDF 
SEO-SFF 



Uppercase letters 
Special characters 
Uppercase letters 
Special characters 

Uppercase letters 
Special characters 
Uppercase letters 
Lowercase letters 



Inverse Uppercase leHers Inverses 

Inverse Special characters Inverse 

Flashing Uppercase tetters Inversa 

Hashing Lowercase letters Inverse 

Normal Uppercase tetters Normal 

Normal Special characters Narmal 

Normal Uppercase letters Monmal 

Normal Lowercase letters Normal 



Table 2-7 Low-resolution Graphics 
Cobrs 

Colors may vary, depending upon the 
controls on the monitor or television 
set. 



Table 2-3 High-resolution Graphics 

Colors 

Colors ma^ vary, depending on the 
adjustment at the monitor or television 
8el. 



Nybble Value 


CoFor 




Nybble Value 


Color 


Decimal 


Hex 






Decimal Hex 







$0 


Black 




8 


SB 


Brown 


1 


SI 


Magenta 




9 


S9 


Orange 


2 


S2 


Dark Blue 




10 


SA 


Grey 2 


3 


S3 


Purpie 




It 


SB 


Pink 


4 


S4 


Park <3reen 




12 


sc 


Ltghl Green 


5 


S5 


Grey 1 




13 


SD 


Yellow 


6 


S6 


Medium Bfue 




14 


£E 


Aquamarina 


7 


E7 


Light Blue 




15 


SF 


White 


Bits 0-6 






BMTOfl 




Bit 7 On 




Adjacent columns 


off 


Slack 1 




Black 2 




Even columns on 




Purpie 




Blue 




Odd colurr 


ins on 




Green 




Orange 




Adjacent columns on 


White 1 




White 1 





Tables 



201 



Table 2-9 Video Display Pago 
Locators 

•Note: SO-column mode uses Ehe 
1024-bvte page-l locations ir both 
mam and auxiliarv Tnemory, The 
PAG£2 5wiich is used to selecl one 
or Ihe oilier far slarrng data (see I he 
section Display Mode Swilcliing"). 



Display mode 



40-colijmfiText, 

Low-resolution 

Graphics 



&0-colunin Text 



High -resolution 
Graphics 



1* 



1 
2 



Lowest 
Address 



*900 SOflQ 



tAtiO 



10E4 



*£000 8192 
I4Q00 1S3S4 



Highest 
Address 



»7FF 2Q17 
*BFF 3071 



• 7FF 



2047 



*3FFF 15383 
*SFFF £4575 



i 

'i 
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Table 2-10 Display Soft Switches 

[1 1 This mode is only effecliye wlien 
grapliics-mode swilch is ON. 
{2] This switch has a dilferenl lunction 
when the 80-colLjmn levX cards 
auxiliary lent page \s enabied for 
writing, Refer to the rexi section, 
"Addressing Dispiay Pages Direciiy.'* 

(3) Tnis switcH Changes (he tuncfian of 
the PAGE2 switch for addressing tlie 
ajxiliary text rnemory on the exlended 
80-column texl card. The next section 
describes how to do Ihis, 

(4) Reading (his focation returns the 
state of ifie vertical blanking 
signal VBL . The runction of VBL is 
described in Chapter 7 in the section 

Video Output Signals." 



Name 



Function 



Hex 



Location 
Decimal 



Notes 



ALTCHAR5ET 



TEXT 



MIXED 



HIRES 



SOCOL 



AEternale char, set pn 
Atlernate char, set off 
Read flLTCHAGSET SWfllCh 



JCOOF ^9167 -16369 Write 
•COOE 4918& -1637Q Wrtte 
tCDIE 49182 -163S4 Read 



Text mode on 

Text mode off {graphics] 

Read text switch 



•CDS1 A9233 -16303 
JC050 4923? -16304 

tCOiA 49179 -leass Read 



Mixed-mod© on 
Mixed-modeoff 

Read til XED switch 



*C0E3 49235 -16301 t 
tCDS£ 49234 -1S302 1 
*C01B 49179 -16357 Read 



PflOE2 Page 2 on 

Page Zoff (Page 1j 
Read PACES swit&h 



*COSS 49237 -16S99 2 
tC0S4 49336 -16300 2 
CCD1C 491 BQ ~163B6 Read 



HI res mode on 
Hi-res mode off 
Read Hi RES switch 



tCD57 49239 1 G297 1 
tCOSB 4923S - 1 G29B J 
»C01D 49191 -1635S Read 



eo-colurno display on 
80-coiumn display ofl 
Read SDCDL switch 



»COOD 4916S -16371 Write 
ICODC 491G4 16372 Write 
tCOlF 491 S3 -1G353 Read 



aOSTORE Store in auxiliary memory 

Store in main memory 
Read 30 5 TO RE switch 



*C0D1 49153 -1G3S3 Write, 3 
tCQOO 48152 -163B4 Write, 3 
IC018 491 7G -16360 Read 



VBL 



Read vertica9 t>lariking 



«C01 9 49t 77 1 G3S9 Read. 4 
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Table 2-11 Annunciator Memory 

Losatioris 

'Pir numbers given are for the 16-pin 
IC connector on Ihe ci^'cuit board. 



No. 



i 



204 



Annunciator 

Pin' Slate 



15 



14 



13 



12 



Tables 



on 



off 

on 



off 

Oft 



off 
on 



Address 
Doclmal Hex 



49240 -1G29G *C058 

49241 -1629S tCOSS 



4924£ -ie£94 
49243 -16293 



tCOSB 



49244 -16292 tCOBC 

49245 -16291 «CQ5D 



4924G -tG290 *COSE 
49247 -16289 «C05F 



1 

i 



Table 2''12 Secondary I/O Memory 






Address 




Localions 


Function 


Decimal 


Hex 


Motw 


For connedor identification! and pin 












numbers, refer to Tables 7-1 7 and 


Speaker 


43200 


-ie33S 


tC030 


Read 


7-1 a 














Cassette Out 


431 S4 


-16352 


tCD20 


Read 




Cassette In 


493'tS 


^8296 


SCDBO 


Read 




Annunciator On 


49241 


- 1 6295 


IC059 






AnrurtcialorOOff 


49240 


- 1 629G 


fDDEQ 






Annunciator i On 


49243 


-16233 


tCDBB 






Annunciator i Off 


43242 


-1G294 


»C05A 






Annunciators On 


4924S 


16291 


ICOSD 






AnnyncialOi-2 Off 


49244 


-1629^ 


*C05C 






Annunciator 3 On 


49247 


- 162B9 


*COSF 






Annundator 3 OH 


43246 


-16290 


tC05E 






Strobe Output 


4321 B 


-16320 


»C040 


Read 




Switcti Input D 


49249 


- 1 6297 


• C061 


8eed 




( |aPEN~flPPLE key) 












Switcti Input 1 


49250 


-16286 


tCDG2 


Read 




(1 SDL]D-APPL£| key) 






Switcti Input 2 


432B1 


-16285 


«C0b3 


Read 




AnaFog Input Reset 


49264 


-16272 


•C070 






Analog Input D 


492B2 


-16284 


tC0G4 


Read 




Analog Input 1 


49253 


-16263 


*C065 


Bead 




Analog Input 2 


492S4 


- 16282 


IC066 


Riead 




Analog Input 3 


49255 


-16291 


«C0E7 


Read 



Tables 



2D5 



Table 3-3s Corirol Characters with 

CDUT1 

{1 ) Onlv available when 8D-column 
firmware is active, 
(2] Only works from thte keyboard. 
(3) Ooesn t work from I he keyboard. 



L 
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Central 
Charac1«r 



ASCII Apple Me Action Taken by CDUT1 
Name Name 



Notes 



CONTROL - G 



| cdmtrol| - 



(BEL) bell 

tBS] backspace 



ICQNTRDLJ - J (LF) lirs fged 



I COWTRQL 1 - K 



CQNTHDL - L 



{VT) clear EOS 
(FF) Clear 



I CDNTROT] - M (CR) return 



rCDNTRDL - M 



CDNTRDL - □ 



CONTROL - Q 



i CQNTRDLl - fi 
rCQHTRDLl - S 



(SOI nDFTTial 

[SI) inverse 

lOCl] 40-column 

(DC2) 80-column 

(DS3] slop'lisi 



Produces a lOOO Hz tone tor 

0.1 second. 

Moves c jrsor position ona 

Space to the left; from left edge 
of window, moves to nghit end 
of line above. 

Moves cursor posrtion down to 
next line in window; scrolls if 
needed, 

Clears (roiri cursor position to 1 
the end of the window. 

Moves cursor position to upper 1 
left corner of window and ciears 
window. 

Moves cursor position to left 
end a\ next line in window; 
scrolls if needed. 

Sets display formal rtormai- 1 , 3 

Sets display lormat Inverse. 1, 3 

Sets display to 40-CDlumn. 1 

Sets display to SO-column. 1 

Slops sending characters to the 1 , 2 
display, until a key is pressed- 
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Table a-Sb Control Characters with 
COUT; , continued 

(1 ) Only avajlable whgn QQ-cnlumn 

firmware is active. 
i2) goloXY IS not supported under 
BASIC: see the Apple Pascaf 
Operstmg System Reference Manual. 



Control 
Character 



ASCII Apple lie 
Name Name 



Action Taken by coun 



Notes 



ICDMTRDLh ^ (NAK) qjit 



I COKTROLf - W (SYN) scroll 



[COHTRQLj - 14 (ETB) acrolJ-up 



ICPMTRQL |- ¥ (EM) home 



[CDWTROLl - Z [SU B) dear line 



Deactivates dQ-EOiLimn 1 

firmware, homes cursor. 
and clears screen. 

Scrolls the display down 1 

one tine, leaving the cursor 
in the currenl position. 

Scrolls the display up one 1 
line, leaving Ihe- cursor in 
the current posilior. 

Moves cursor position to 1 

upper teft comer of window 
(but doesn't ciearl. 



Clears the line the cursor 
posft^DD is cn. 



1 



[COMTROLJ- \ (FS) fwd. space 



[CDMTROL 1 



CONTROL 



(GS) 



(RS) 



clear EOL 



gotoXY 



f^oves cursor position one 1 
Space to Ihe right; from 
right edge of window, 
moves it to ^eft end of line 
belov/- 

Clears line irom cursor 1 

position to Ihe right edge of 
the window. 



Using the next two 
characters, minus 32. as 
ane-byte X and Y values, 
moves the cursor position 
1oCH = X. GV = y 



i,a 





Table 3-4 Test Window 


Memory 
























L-^ 


Locations 




























L 


Window 


Location 




Minimum 




format Values: 






Maximum 


1 Values: 






Parameter 








Val 


lue: 


40cOl. 


flOcol- 




4acoi. 


BDcdL 






Dec 


Hex 


Dec 


Hex 


Dec 


Hex 


Dec 


Hex 


Dec 


Hex 


Dec 


Hex 


i ^ 


Lei Edge 


32 


S20 







SO 





SO 





$0 


39 


E27 


79 


S4F 


*- — ^ 


Width 


33 


S21 







so 


40 


$23 


BO 


S5D 


40 


$28 


ao 


sso 


1 -4 


Top Edge 


34 


S22 


a 




so 





SO 





$0 


23 


$17 


23 


$17 




Bottom Edge 


35 


*23 


1 




Si 


2A 


$15 


24 


St 8 


24 


$ie 


24 


$18 


t3 




























































L ^ 
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Table 3-^ Escape Codes 

(1 ) Old-style cursor-control key: 
see text. 

(2) Curscn-control key; see tejft. 

(3) TriiB code tunclions orSy when the 
SOcolumn lintiware is active. 



Escape Code 


Function 


Notes 




Clears the window and homes the cursor 

Moves the cursor up one line 

MdvBs. Ihe cursor right one space 

Moves Ihe cursor left one space 

Moves (he cursor down one line 

Clears to tha and of tha line 

Clears to the bottom of the wfndnw 

Moves the cursor up one line and turns on 
escape mode 

Moves the cursor left one space and turns on 
escape mode 

Moves (he cursor right one space arid turns on 
escape mode 

Moves (he cursor down one line and tuma on 
escape mode 

Turns on re&tficted-case mode 

Turns OR restrtcted-case mode 

Switches to 40-eolumn mode, homes ^e 
cursor, and clears the screen 

Switches to 80-column mode, homes ttie 
cursor, ar^d clears the screen 

1 Deactivates the eO-co!umn firmware 




[ESC |@ 




1 ESC j A 

[esc] B 


1 
1 


|_E SCj C 


1 


1 ESC J D 


1 


1 ESC 1 E 




|ESC|F 




1 ESC 1 I 


2 


1 escj t 




1 ESC U 
|ESC| — 


2 


i ESC ] i; 


2 


I ESC K 




1 ESC 1 fl 


2 


1 ESC 1 { 




i ESC ] R 
f ESC 1 T 

[esc] 4 


3 

2 


1 ESC 1 a 


3 


j ESC ||CDHTRaL|-C 


3 
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Table 4-5 Bank Sslect Swtlches 

(1 ) This swilch write-enables HAM 

and read-enal)les ROM. 

{2) Two successive reads to this 

switch enables RAM both for reading 
and writing. 



Switch 
Addfe$s 



tCGSQ 

iCGai 
*coa2 

SC083 
*C084 
*C08S 
tC086 

*C087 
tCGSQ 

tCCSA 
tCG8B 

*C08C 

tCGSD 
ICG8E 
iCGSr 



Write 

RAM 



Read 
RAM 



Read 
ROM 



4KnAM Bank: 
First Second 



Notes 



1 
2 

1 
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Table 4-6 AjKilrary-memDry Select 
Switches 

(■l)Wher BO STOKE is on. ihe PAGES 
swiicin selects mam gr auxiliary display 
memDry. 

<2] When BOSTOREJson.the HIRES 
switch enables you to use Ihe PftGEa 
s-rtitch to switcti between the 
high-re&nluliori page-l area in main 
memory or auxiliary memory. 



hJame 


Function 


Location 




Notes 


J 






Hex 


Dealmai 




^ 


BAMRD 


Read auxiliary memiory 


»CO03 


49155 


-t63Sl 


Write 


J 




Read main memory 


»C0C2 


491 54 


1G382 


WnIO 


^ 




'Read RANRDswitch 


*CD1 3 


49171 


- 16365 


f^ead 


J 


Rf^MURT 


Write auxiliary memDry 


«C0D5 


49157 


-1G379 


Write 


n 




Write main memory 


»C004 


49156 


-1S380 


Write 


J 




Read RflflWRT switch 


• C014 


49172 


-16354 


Read 


R 


eOSTORE 


On: access display page 


*C001 


49153 


- 163B3 


Write 


d 




Oft: use RAMRD. RftMWRT 


tCQ'DO 


49153 


- 163B4 


Write 


^l 




Read saSTGRE switch 


*C01B 


491 7G 


- 1 e360 


Read 


^ 


PAGE 2 


Page 2 on (Aux. memory) 


*C[35B 


49S37 


- 16239 


1 


u 




Page 2 oft (Main memnry) 


SCQ54 


49236 


-16300 


1 


cd 




Read p^GE 2 switch 


«C01C 


491 BD 


- 16356 


Read 


"1 


HIRES 


On: access hi-res pages 


*C0S7 


49239 


-16297 


2 


d 




OfllJSe RAMRD. RAP1WRT 


tCD5€ 


4923S 


1629B 


2 


1 




Read HlREBswitch 


*CD1D 


491 ai 


- 16355 


Read 


d 


flLTZP 


Auxiliary stack & z. p 


tCOOQ 


49161 


16373 


Write 


r^ 




Mam stack & zero page 


tcooe 


491 SO 


- 1537*1 


Write 


^3 




Head flLTZPSwitcli 


*C01B 


431 74 


15352 


Read 


ft2 

i 
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Table 4-10 Page 3 Vectors 



Vector address 
Decimal Hex 



Vector function 



1 008 $3F0 Address of the subroutine that handles BRK requests 

1009 *3F1 (normally tss, *Ffl). 



iClO t3f2 Reset vector (see text), 

1011 t3F3 



ICIZ i3F4 Power-up byte (seetexi). 



1GI3 


»3FS 


1Q14 


*3F6 


tCIB 


t3F7 



Jump instruction lo llie subroutfne that handles Applesoft 

"&" commands (normally t^C. *58, IFF), 



1016 


*3FB 


1D17 


*3F9 


1018 


fSFA 



J ump instruct ion Id the subroulrne Ihat handles user 
(IcQHTROlI" Y 3 commands, 



1019 
1020 
1021 



t3FB 
*3FC 
*3FD 



Jump instruction to the subroutine lliat handles 

non-maskable interrupts. 



1 022 tSFE Inlerrupt vectof (address o\ the subroutine that handles 

1 023 OFF interrupt requests)- 
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— ^ ■ 










J 


T«bl» 6-1 P^rfphflral-card I/O 


Slot 


Lacatlorts 


Enabled by 




Mgmorv Locations 








" I 


Note: The enabling signal is marked 


1 


»C090-*C0BF 


DEVICE SELECT' 


^ 


Willi a. prime, to indicale that it is an 








ets 


active-low signal. 


2 


•COflO-*COAF 


ECVICE SELECT' 


^ 1 




3 


«C<3Ba-*C0BF 


DEVICE SELECT' 


J 




4 


*COC0-»C0CF 


DEVICE SELECT' 


^ 




5 


*COD0-»C0DF 


DEVICE SELECT' 


J 




e 


*ca€o-icof:F 


DEVICE SELECT' 


^ 




7 


iCOFO-tCOFF 


DEVrCE SELECT' 


H 


Table &-2 Peripheral'Cafd ROM 


Slot 


Location* 


Enabled by 


H 


Wemory Locations 








1 


Notei The enaHling signal is marted 


1 


»C100-»C1FF 


1/D SELECT' 


i^ 


with a prime, to indicate that it is an 








^^ 


active-low slgnal- 


2 


*C200-«C£FF 


1/0 SELECT' 


J 




3 


*C300-tC3FF 


UD SELECT' 


ri 




4 


*C400-»C^FF 


I /D SELECT' 


n 




5 


•C5D0-«C5FF 


1/0 SELECT' 


^ 




6 


IC6Q0-IC6FF 


I/a SELECT' 


n 




7 


•C700-1C7FF 


I/O SELECT 


H 










d 

1 


212 


Tables 






J 



Tdble 6-3 Peripheral'card RAM 
Memory Lo&alions 

'Note; The RAM localions normally 
ailFocated \o slot 3 are taken over by 
any card En&ialled in the auxiliary sSot 



Base 
Address 


1 


2 


Slot Numbei- 
3' 4 


5 


S 


7 


«0478 


*0479 


»G47A 


*t547B' 


*0^7C 


»047D 


*047E 


*047F 


*04Fa 


*04F9 


«04Fft 


*04FB' 


*04FC 


tOAFD 


*04FE 


*04FF 


• 0S78 


♦ OS 79 


*057P 


*057B* 


«0S7C 


t057D 


»057E 


I057F 


*Q5FS 


»05F9 


*05Ffl 


*05FB* 


«OSFC 


tOSFD 


*05fe: 


iOEFF 


«D&7S 


10679 


t067A 


»0B7B* 


*067C 


»0e7D 


*oe7E 


*oe7F 


«D6FS 


iOeF9 


• 06FA 


*OSFB* 


*06FC 


»06FD 


*OEFE 


«06FF 


»077S 


10779 


J077A 


*077B* 


t077C 


t077D 


»077E 


t077F 


ta7F8 


«07F9 


tri7FA 


in7FB* 


tO?FC 


*07FD 


*07FE 


• 07FF 
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Table 6-4 Peripheral-card I/O Base 
Addresses 


Base 

AddreSfi 


1 


2 


Connector Number 
3 4 5 


fi 


7 


1 

^ 1 




icoeo 


tCD90 


ICQFIQ 


«COBO 


tCDCO 


SCDDD 


tCOEQ 


ICOFO 


J 




*coei 


»C091 


*CQA^ 


■ CQS1 


ICOCt 


*C0D1 


tCQEl 


tCOFt 


'J 




ICDS£ 


JC092 


»C0A2 


*CDB2 


»C0C2 


«coDa 


%CiiZ2 


tC0F2 


d 




IC093 


IC093 


*C0A3 


fCOBi 


1C0C3 


*C^l>3 


*CQE3 


*C0F3 


\ 




<C0S4 


»C094 


tCOAl 


icos4 


tcoc^ 


tCOD-t 


*CQE4 


tC0F4 


d 




fCOBS 


IC095 


tCOAS 


*CDB5 


scocs 


tCODS 


*CQ£S 


tCOFS 


n 




tCOB€ 


*C096 


tCO^G 


tCOBG 


ICOCG 


*C0D6 


tCOGB 


tCOFG 


d 




tC087 


tC097 


»C0A7 


«C0S7 


*C0C7 


*CnD7 


*C0E7 


JC0F7 


n 




tcoea 


fC098 


tCOAS 


«COBB 


tcoce 


tCODS 


tCOEB 


IC0F8 


d 




»coa9 


IC099 


*C0A9 


tCDB9 


*C0C9 


tcong 


*C0E9 


»C0F9 


n 




tC08A 


tCOSA 


fCOAA 


SCQ8A 


tCOCfl 


tCODA 


*COEA 


JCOFfl 


d 




tCQBB 


tcoeB 


fCOAB 


tCDBB 


SCOCB 


tCODB 


«COEB 


ICOFB 


\ 




»COBC 


IC03C 


*COAC 


tCDBC 


tcocc 


JCODC 


tCOEC 


tCOFC 


d 




tC08D 


1 C D3D 


*COAD 


tCOBD 


tCQCD 


*CDDD 


*COED 


»COFD 






SCOSE 


tC09E 


«COAC 


ICQBC 


tCOCE 


I CODE 


tCQEE 


tCOFE 


sd 




tCDSF 


tG09F 


*COflF 


tCCBF 


«COCF 


ICODF 


<COEF 


*COFF 




Table fi-5 I/O Memory Switches 


Name 


Function 




Location 
Hex Decimal 


Holes 


5?^ 




5Lt]TC3R0?1 Slol ROM a1 l 


C300 


tnoQB 


49163 


-16373 Write 


CZ 






Internal ROM at »C30D 


*nODA 


49t6S 


-16374 Write 








Read SL0TC3BnM switcl- 


tC0l7 


491 7S 


-1G361 Read 


!£r^ 






















SLOTCXRQM Slol ROM at *CkO0 


*CQ07 


4915a 


-16377 Write 


B 






Internal ROMal*CK0Ct 


tcooe 


49156 


-1G37B Write 


ff*^ 






Read SLOTCXROM switch »CC15 


4917 3 


- 1 6363 Read 


^ 




















i 
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Appendix C 



Directory of Built-in 
Subroutines 



Here is a list of useful subroutines in the Apple lie's Monitor. To 
use these subroutines from machine-language programs, store 
data into the specified memory locations or 6502 registers as 
required by the subroutine and execute a JSR to the subroutine's 
starting address. After the subroutine performs its function, it 
returns with the 6502 s registers changed as described 



Warning 

For the sake of compaiabiiity between the Apple II Plus 
and the AppJe lie. do not jump into the middle of Monitor 
subroutines, The starting addresses are the sarne tor all models of 
the Apple II. but the actual code is different. 



BELL Output a fc>ell character 



1FF3A 



BELL writes a bell ( | CDNTRPL | -G) character to the current output 
device. It leaves the accumulator holding *S7. 



BELLI Send a beep to the speaker 



SFBDD 



BELLI generates a 1 kHz tone in the Appie lie's speaker for 0.1 
second. It scram bEes the A and X registers. 



CLREOL Ciear to end of tine 



*rc9C 



CLREDL clears a text line from the cursor position to the right edge 
of the window- CLREQL destroys the contents of A and Y. 



CLEOLZ Clear to end of line 



SFC9E 



CLEOLZ clears a text line to the right edge of the window, starting 
at the location given by base address basl indexed by the 
contents of the Y register CLEOLZ destroys the contents of A 
and Y. 
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CLREOP Clear to end of window 



*FC42 



CLREOP clears the text window from the cursor positfon to the 
bottom of the window. CLREOP destroys the contents of A and Y. 



CLRSCR Clear the low-resolution screen 



*Fe3£ 



CLRSCR clears the low-resolution graphics display to black. If you 
call CLRSCR while the video display is in text mode, it fills the 
screen with inverse-mode at-sign (@) characters. CLRSCR destroys 
the contents of A and Y. 



CLRTOP Clear the low-resolution screen 



tFS36 



CLRTOP is the same as CLRSCR (above), except that it clears onty 
the top 40 rows of the low-resolution display. 



COUT Output a character 



$FDED 



cnuT calis the current character output subroutine. The character 
to be output should be in the accumulator. couT calls the 
subroutine whose address is stored in CSw (locations *36 and *37). 
which is usually the standard character output COUTI . 



C0UT1 Output to screen 



tFDFO 



CDUT1 displays the character in the accumulator on the Apple lie's 
screen at the current output cursor position and advances the 
output cursor. It places the character using the setting of the 
Normaiy Inverse location. It handles the control characters 
[return 1 . linefeed, backspace, and bell. It returns with all registers 
intact. 



CROUT Generatea I RETURN 



• FD8E 



CROUT sends a I RETURN I character to the current output device. 

CHOUT1 [return I with clear • FD8B 

CR0UT1 clears the screen from the current cursor position to the 
edge of the text window, then calis grout. 



GETLN Get an input line with prompt 



• FD6A 



GETLN is the standard input subroutine for entire fines of 
characters, as described in Chapter 3. Your program calis GETLN 



Directory of Built-in Subroutines 
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with the prompt character in location *33; GETLN returns with the 
input line in the input buffer (beginning at location *20 0) and the 
X register holding the length of the input line. 



GETLNZ Get an input line 



• FD67 



GETLNZ is an alternate entry point for getln that sends a carriage 
return to the standard output, then continues into GETln. 



GETLN1 Get an input line, no prompt 



*FD6F 



GETUNi is an alternate entry point for getln that does not issue a 
prompi before tt accepts the input line. If, however, the user 
canc els the input line, either with too many backspaces or with a 
I CQNfROL~| 'X. then GETLNi will issue the contents of location 
* 33 as a pfompi when it gets another line. 



HLINE Draw a horizontal line of blocks 



♦ F819 



HL INE draws a horizontal line of blocks of the color set by setcol 
on the low-resolution graphics display- Call hline with the vertical 
coordinate of the line in the accumulator, the leftmost horizontal 
coordinate in the Y register, and the rightmost horizontal 
coordinate in location »£C. hline returns with A and Y scrambled, 
X intact. 



HOME Home cursor and clear 



»FC53 



HOME clears the display and puts the cursor in the home position: 
the upper left corner of the screen. 



lOREST Restore all registers 



JFF3F 



IDREST loads the 6502's internal registers with the contents of 
memory locations *45 through »ia. 



iOSAVE Save all registers 



«FF4A 



IOSAVE Stores the contents of the 6502's internar registers in 
locations *45 through «49 in the order A, X, Y, P; S. The contents 
of A and X are changed and the decimal mode is cleared, 



KEVIN Read the keyboard 



IFD1B 



KEY IN is the keyboard input subroutine. It reads the Apple lies 
keyboard, waits for a keypress^ and randomizes the random 
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number seed at *4E-I4F. When a key is pressed, <ey]n removes 
the blinking cursor from the display and returns with the keycode 
in the accumuJator. KEY in is described In Chapters. 



MOVE Move a block of memory 



«FE£C 



MOVE copies the contents of memory from one range of locations 
to another. This subroutine is the same as the move command in 
the Monitor, except it taltes its arguments from pairs of locations 
in memory, low-byte first. The destination address must be in A4 
(»^2-i43), the starting source address in A1 [*3C-t3D). and the 
ending source address in A2 (*3E-»3F) when your program calls 

MOVE. 



NEXTCOL Increment coior by 3 



• F3SF 



NEXTCDL adds 3 to the current color (set by SETCOL) used for low- 
resotution graphics. 



PLOT Ptot on the low-resolutEon screen 



*F8oa 



PLOT puts a single block of the color value set by SETCDL on the 
low-resolution display screen. The block's verticaf position is 
passed In the accumulator, its horizontal position in the Y 
register, plut returns with the accumuiator scrambted, but X and 
V intact. 



PRBLNK Print 3 spaces 



tF94B 



PRBLNK outputs three blank spaces to the standard output device. 
On return, the accumuiator usually contains 'AO, the X register 

contains 0. 



PRBL2 Print many blank spaces 



tF94A 



PRBL2 outputs from 1 to 256 blanks to the standard output device. 
Upon entry, the X register should contain the number of blanks 
to be output. If X-$00, then PRBL2 wiil output 256 blanks. 



PRBYTE Print a hexadecimal byte 



*FDDA 



PRBVTE outputs the contents of the accumulator in hexadecimal on 
the current output device. The contents of the accumulator are 
scrambled. 
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PREAD Read a hand control 



(TBIE 



PREflD returns a number that represents the position of a hand 
controL You pass the number of the hand control in the X 
register. If this number is not valid (not equal to 0, 1, 2, or 3), 
strange things may happen, PREAD returns with a number from 
SOO to $FF in the Y register. The accumulator is scrambled. 



PREHR Print ERR 



«FF2D 



PRERR sends the word err, followed by a t:^ell character, to the 
standard output device. On return, the accumulator is scrambled. 



PRHEX Pnnt a hexadecimal digit 



*FDE3 



PRHEX iprints the [ower nybble of the accumulator as a single 
hexadecimal digit. On return, the contents of the accumulator are 
scrambled. 



PRNTAX Print A and X in hexadecimal 



<F911 



PRNTAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte 
output, the X register contains the second. On return, the 
contents of the accumulatcr are scrambled. 



RDCHAR Get an input character or ESC code 



*FD3S 



RDCHAR is an alternate input subroutine that gets characters from 
the standard input subroutine, and also interprets the escape 
codes listed in Chapter 3. 



RDKEY Get an input character 



tFDOC 



RDKEY is the character input subroutine. It places a blinking cursor 
on the display at the cursor position and jumps to the subroutine 
whose address is stored in KSu (locations *38 and *39), usually 
the standard input subroutine KEVIN, which returns with a 
character in the accumulator. 



READ Read a record from a cassette 



*FEFD 



READ reads a series of tones at the cassette input port, converts 
them to data bytes, and stores the data in a specified range of 
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memory locations. Before calling READ, the address of the first 
byte must be in A1 (*3C-»3D) and the address of the last byte in 
A2 (J3E-3F.) 

READ keeps a running Exclusive DR of tiie data bytes in CHkSUM 
(*2£). When the last location has been tilied, READ reads one more 
byte and compares it with chksum. If equal, READ sends out a beep. 
and returns; if not, it sends "ERR" through CQUT, sends the beep. 
and returns. 



SCRN Read the low-resolution graphics screen 



*F971 



5CRN returns the color value of a single block on the low- 
resolution graphics display. Call it with the vertical position of the 
block in the accumulator and the horizontal position in the Y 
register. Call it as you would call plot (above). The color of the 
block will be returned In the accumulator. No other registers are 
changed. 



SETCOL Set low -resolution graphics color 



tF&BA 



SETCOL sets the color used for plotting in low- resolution graphics 
to the value passed in the accumulator. The colors and their 
values are listed in Table 2-7. 



SETINV Set Inverse mode 



*FEeo 



SET I K^ sets the dlslay format to inverse. COUT i will then display all 
output characters as black dots on a white background The Y 
register is set to »3F, all others are unchanged. 



SETNORM Set Normal mode 



»FEe4 



SETNORM sets the display format to normal. cnuTi will then display 
all output characters as white dots on a black background. On 
return, the Y register is set to •FF, all others are unchanged. 



VERIFY Compare two blocks of memory 



• FE36 



VER 1 FV compares the contents of one range of memory to 
another. This subroutine is the same as the VERIFY command in 
the Monitor, except it takes its arguments trom pairs of locations 
in memory, low-byte first. The destination address must be in A4 
(«42-*43), the starting source address in A1 (»3C-t3D), and the 
ending source address In A2 (*3E-*3F) when your program calls 
VERIFV. 
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VLINE Draw a vertical line of blocks 



«FS2e 



VL [NE draws a vertical line ot blocks of the color set by SETCGL on 
the low- resolution display. You should call vlImE with the 
horizontal coordinate of the line in the Y register, the top vertical 
coordinate in the accumulator, and the bottom vertical coordinate 
in location »2D. vlIHE will return with the accumulator scrambled. 



WAIT Delay 



«FCA8 



WAIT delays for a specific amount of time, then returns to the 
program that called il The amount of delay is specified by the 
contents of the accumulator. With A the contents of the 
accumulator, the delay is 1/2{26+27A+5A"2) microseconds. WAIT 
returns with the accumulator zeroed and the X and Y registers 
undisturbed. 



WRITE Write a record on a cassette 



»FECD 



WRITE converts the data in a range of memory to a series of 
tones at the cassette output port. Before calling WR I te , the 
address of the first data byte must be in A1 (*3C-<3D) and the 
address of the last byte In A2 (*3E-*3F). The subroutine writes 
ten-second continuous tone as a header, then writes the data 
followed by a one-byte checksum. 
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Appendix D 

Differences Between the 
Apple lie and the Apple II 
Plus 



The Apple lie (s the tatest model Apple II, and it includes several 
improvemenls over the older models. The improvements and 
other differences are listed here in approximately the order you 
are likely to encounter them: otsvious differences first technical 
details later Each entry in the list includes references to the 
chapters in this manual where the item Is described. 

Full Keyboard 

The Apple Me has a full B2'key uppercase and lowercase 



keyboa rd. T he keyboard includes fully-operationai i SH 1 FT | 
and , CAPS L DCK I keys- It aiso includes tour directional arrow keys 
for moving the cursor Chapter 2 includes a description of the 
keyboard. The cursor-motion keys are described fn Chapter 3. 

Apple Keys 

The keyboard of the Apple lie has two keys m arke d with the 
Apple logo. Thes e keys, called the ^ DPEN-flPPLE J and 
LBDL ID-APPLE_1 keys, are used with the i_RES£l^| key to select 
special reset functions. They are connected to the buttons on the 
hand controls, so they can be used for special functions in programs. 

Lowercase Display 

The Apple lie can display the full ASCII character set, uppercase 
and lowercase. For compatibility with older Apple lis, the 
standard display character set includes flashing uppercase 
instead of inverse-format lowercase; you can also switch to an 
alternate character set with inverse lowercase and uppercase, but 
no flashing. Chapter 2 includes a descrlptjon of the display 
character sets. Chapter 3 tells you how to switch display formats 
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Optional 80-column Display 

With the addition of an SO-column text card, the Apple He can 
display 60 columns ot text. The SO-column display is completely 
compatahle with botti graphics modes — you can even use it in 
mixed mode. (If you prefer, you can use an old-style 80-coiumn 
card in an expansion slot instead.) Chapter 2 includes a 
descnption of the SO-coiumn display. 

Additional Escape and Control Keys 

The display features mentioned above (and many others not 
mentioned) can be controlled from the keyboard by escape 
sequences and from programs by control characters. Chapter 3 
inciudes descriptions of those escape codes and control 
characters. 

Built-in Language Card 

The 16K bytes of RAM you add to the Apple II Plus by instailing 
the Language Card is built into the Apple lie, giving It a standard 
memory size of 64K bytes, in the Apple lie, this 16K-byte block 
of memory is called the Bank-switched Memory. It is described in 
Chapter 4. 

Optional Auxiliary Memory 

By installing an extended ao-column te>ct card, you can add an 
alternate 64K bytes of RAM to the Apple Me. Chapter 4 tells you 
how to use the additional memory. (Compatibility note: the 
extended 80-column text card also provides the 80-column 
display option.) 

Auxiliary Slot 

In addition to the normal expansion slots there is a special slot 
that is used either for the optional 80-column text card or for the 
extended eo-cotumn text card. This slot is identified in Chapter 1 
and described in Chapter 7, 

Back Panel and Connectors 

The Apple lie has a metal back panel with space for several D- 
type connectors. Each peripheral card you add comes with a 
connector that you install in the back panel. Chapter 1 inciudes a 
description ot the back panel; for details, see the installation 
instructions supplied with the peripheral cards. 
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Additional Soft Switches — Readable, Too 

The additional display and memory features of the Apple lie are 
controlfed by soft switches like the ones on the Apple II Plus. On 
the Apple lie, programs can also read the settings of the soft 
switches. Chapter 2 describes the soft switches that control the 
disptay features, and Chapter 4 describes the soft switches that 
control the memory features. 

Built-in Self Test 

The Apple lie has additional built-in firrrtware that includes a self- 
test routine. The self-test is intended primanly for testing during 
manufacturing, but you can run it to be sure the Apple He Is 
working correctly. The self-test is described in Chapter 4. 

Forced Reset 

Some programs on the Apple II Plus take control of the reset 
function to keep users from stopping the machine and copying 
the program. The Apple Me has a forced reset that writes over 
the program in memory. By using the forced reset, you can 
restart the Apple lie without turning power off and on and causing 
unnecessary stress on the circuits. The forced reset is described 
in Chapter 4. 



Interrupt Handling 

Even though most application programs don't use interrupts, the 
Apple lie provides for interrupt-diiven programs. For example, the 
BO-column firmware periodically enables interrupts while it is 
clearing the display {normally a long time to have interrupts 
locked out). Interrupts are discussed in Chapter 6. 

Vertical Sync for Animators 

Programs with animation can now stay in step with the display 
and avoid flickering objects in their displays. Chapter 7 includes a 
description of the video generation and the vertical sync. 

Apple lie Signature Byte 

A program can find out whether it's running on an Apple lie or on 
an older model Apple II by reading the byte at location *FBB3 in 
the System Monitor. In the Apple lie Monitor, this byte s value is 
$06; in the Autostart Monitor [the standard Monitor on the 
Apple M Plus), Its value is $EA. {Note: if you start up with DOS 
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and switch to Integer BASIC, the Autostart Monitor is active and 
the vaiue at locaUon *fbs3 (s SEA, even on an Apple He.) 
Obviously, there are lots of other locations that have different 
values in the different versions of the Monitor; location *rBB3 was 
chosen because it will have the value $06 even in future 
revisions of the Apple lie fvflonitor. 

Hardware implementation 

The hardware implementation of the Apple Me is radically different 
from the Apple II and Apple II Plus. Three of tlie more important 
differences are 

• The custom ICs: the lOU and MMU; 

• The video hardware^ which uses ROM to generate both text 
and graphics; 

• The peripheral data bus. which is fully buffered. 
All of these features are described in Chapter 7, 
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6502: The microprocessor used in the App*© Me computer. 

accumulator: The register in the 6502 microprocessor where 
most computations are performed. 

acronym: A word formed from the initial letters of a name or 
phrase, such as laser, from Light Amplification by Stimulated 
Emission ot Radiation. 

ADG: See analog-to-digHal converter 

address: A number used to identify something, such as a 
location in the computer's memory. 

analog: Represented in terms of a physical quantity, such as a 
voltage, frequency, length, or position, that can vary smoothly 
and continuously over a range of values. For example, a 
conventional 1 2-hour clock face (remember those?) is an analog 
device that represents the time ot day in terms ot the angles ot 
the clock's hands. Compare digital 

analog-to-digital converter: A device that converts quantities 
from analog to digital form. For example, the Apple lie's hand 
control converts the position of the control dial (an analog 
quantity) into a discrete number (a digital quantity) that changes 
abruptly even when the diai is turned smoothly. 

AND: A logical operator that produces a true result if both of its 
operands are true, a false result if either or both of its operands 
are false; compare OR, excluaive DR, not. 

Apple He: A personal computer in the Apple 11 family, 
manufactured and sold by Apple Computer. 

Apple lie BO-Column Text Cafd: A peripheral card made and 
sold by Apple Computer that plugs into the Apple lie's auxiliary 
slot and converts the computer's display of text from 40- to 80- 
column width. 
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Apple lie Extended 80-Column Text Card: A peripheral card 
made and sold by Apple Computer that plugs into the Apple lies 
auxiliary slot and converts the computer's display of text from 40- 
to 80-column width whUe extending its memory capacity by 64K 
bytes. 

Applesoft: An extended version of the BASIC programming 

language used with the Apple lie computer. An Interpreter for 
creating and executing programs in Applesoft is built into the 
Apple lie system in firmware, 

ASCII: American Standard Code for Information Interchange; a 
code in which the numbers from to 127 stand for text 
characters, used for representing text inside a computer and for 
transmitting text between computers or between a computer and 
a peripheral device. 

assembler: A language translator that converts a program 
written in assembly language into an equivalent program in 
machine language 

assembly language: A low-level programming language in 
which Individual machine-language instructions are written in a 
syrnbolic form more easily understood by a human programmer 
than machme language ftself. 

auxiliary slot: The special expansion slot inside the Apple lie 
used for the Apple BO-Column Text Card or Extended eO-Column 
Text Card. 

back panel: The rear face of the Apple He computer, which 
includes the power switch, the power connector, and connectors 
for a video display device, a cassette tape recorder, and other 

peripheral devices, 

bandwidth; A measure of the range of frequencies a device can 
handle. In the case of a video monitor, greater bandwidth 
enables it to display more information; to display 80 columns of 
text, a monitor should have a bandwidth of at least 12 MHz. 

base address: In indexed addressing, the fixed component of an 
address. 

binary: The representation of numbers in terms of powers of 
two, using the two digits and i . Commonly used in computers, 
since the vaiues and i can easily be represented in physical 
form in a variety of ways, such as the presence or absence of 
current, positive or negative voflago, or a white or black dot on 
the display screen. 
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binary operator: An operator that combines two operands to 
produce a result; for example, OR js a binary logical operator. 
Compare unary operator. 

bit; A binary digit (o or i ): ttie smallest possible unit of 
mformation, consisting of a simple two-way choice, such as yes 
or no, on or off, positive or negative, something or nothing. 

bit bucket: The final resting place of ali information; see write- 
only memory. 

board: See printed-circuit board. 

boot: To start up a computer by loading a program into memory 
from an external storage medium such as a disk. Often 
accomplished by first loading a small program whose purpose is 
to read the larger program into memory. The program is said to 
"puil itself in by its own bootstraps'^ hence the term 
bootstrapping or booting. 

bootstrap: See boot. 

buffer; An area of the computer's memory reserved for a 
specific purpose, such as to hold graphical information to be 
displayed on the screen or \ext characters being read from some 
peripheral device. Often used as an intermediary "holding area" 
for transferring Information between devices operating at different 
speedSr such as the computer's processor and a printer or disk 
drive. Information can be stored into the buffer by one device 
and then read out by the other at a different speed. 

bus; A group of wires that transmit related information, such as 
the bits of an address, from one part of a computer system to 
another. 

byte: A unit of information consisting of a fixed number of bits; 
on the Apple Me, one byte consists of eight bits and can hold any 
value from to 25S. 

card: See peripheral card^ 

carrier: A broadcast radio signal that is modulated in order to 
transmit information. 

carry flag: A status bit in the 6502 microprocessor, used in 
addition and subtraction to hold the high-order bit (the carry bit), 

cathode-ray tube: An electronic device, such as a television 
picture tube, that produces images on a screen coated with 
phosphors that emit light when struck by a focused beam of 
electrons. 
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central processing unit: See processor, 

character: A letter, digit, punctuation mark^ or other written 
symbol used in printing or displaying information in a form 
readable by humans. 

character code: A number used to represent a text character for 

processing by a computer system. 

chip: The small piece of semiconducting materiai (usually silicon) 
on which an integrated circuit is fabricated. The word chip 
properiy refers only to the piece of silicon itself, but is often used 
for an integrated circuit and jts package; see integrated circuit. 

code: (1 ) A number or symbol used to represent some piece of 
information in a compact or easily processed form. (2) The 
statements or rnstnjctions making up a program. 

cold start: The process of starting up the Apple Me when the 
power is first turned on (or as if the power had just been turned 
on) by loading the operating system into main memory, then 
loading and njnning a program. Compare warm start. 

command: A communication from the user to a computer 
system (usually typed from the keyboard) directing it to perform 

some immediate action. 

compiler: A language translator that converts a program written 
in a high-level programming language into an equivalent program 
in some lower-level language (such as machine language) for 
later execution. Compare interpreter. 

component: A part; in particular, a part of a computer system. 

composite video: A video signal that includes both display 
information and the synchronization (and other) signals needed to 
display it. 

computer: An electronic device for performing predefined 
(programmed) computations at high speed and with great 
accuracy. 

computer system: A computer and Its associated hardware, 
firmware, and software. 

connector: a physical device such as a plug, socket or jack, 
used Jo connect one hardware component of a system to 
another. 
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control charaoter: A character that controls or modifies the 




way information is printed or displayed Control characters have 


^^^l'~^ 


ASCII codes between O and 3i and are typed from the Apple Me 




keyboard by holding down the CDNtRDL | key while typing some 




other character. For example, the character | CONTROL | -m (ASCH 


^^^m'~'~ 


code 1 3) means "return to the beginning of the line" and is 




equivalent to the I RETURN I kev- 




controlJer card: A peripheral card that connects a device such 


BA 


as a printer or disk drive to the Apple lie and controls the 




operation of the device. 


^St^ 


CPU: Central processing unit; see processor 




crash: To cease operating unexpectedly, possibly damaging or 




destroying information in the process. 




CRT: See cathode-ray tube. 




cursory A marker of symbol displayed on the screen that marks 




where the user's next action witi take effect or where the next 




character typed from the keyboard will appear. 


pi! J 


DAC; See digitai-to-analog conuerter. 




data: fnformation; especially information used or operated on by 




a program. 




debug: To locate and correct an error or the cause of a problem 




or malfunction in a computer system. Typically used to refer to 


^^1^ 


software- related problems; compare iroubleshoot. 




decimal: The common form of number representation used in 




everyday life, in which numbers are expressed in terms of 




powers of ten, using the (en digits o to 9, 




default: A value, action, or setting that is automatically used by 


^^^■^"^^ 


a computer system when no other explicit information has been 




given. For exampfe. if a command to run a program from a disk 




does not identify which disk drive to use, the Disk Operating 




System will automatically use the same drive that was used in 




the last operation. 




defenestration: The act of throwing something through, from, or 




out of a window. Not recommended handling of an Apple Me. 


B^ 


demodulate: To recover the information being transrpitted by a 


modulated signal; for example, a conventional radio receiver 




demodulates an incoming broadcast signal to convert it into 




sound emitted by a speaker. 


B^ 
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device: (1 ) A physical apparatus for performing a particular task 
or achieving a particular purpose. (2) In particular, a hardware 
component of a computer system, 

device handler: See device driver. 

device driver: A program (hat manages the transfer of 
information between the computer and a peripheral device. 

digit: {1) One of the characters to 9, used to express numbers 
in decimal form. {2) One of the characters used to express 
numbers in some other form, such as and 1 in binary or to S 
and A to F in hexadecimal. 

digital: Represented in a discrete (noncontinuous) form, such as 
numerical digiis. For example^ contemporary digital clocks display 
the time in numerical form (such as 2:57) instead of using the 
;|iositions of a pair of hands on a clock face. Compare analog. 

digital-to-analog converter: A device that converts quantities 
from digital to analog form. 

DIP: See dual in-line package. 

disassembler: A language translator that converts a machine- 
language program into an equivalent program in assembly 
language, more easily understood by a human programmer. The 
opposite of an assembler. 

disk: An information storage medium consisting of a flat, circular 
magnetic surface on which information can be recorded in the 
form of small magnetized spots, similarly to the way sounds are 
recorded on tape 

disk controller card: A peripheral card that connects one or two 
disk drives to the Apple Me and controls their operation. 

disk drive: A peripheral device that writes and reads information 
on the surface of a magnetic disk. 

diskette: A term sometimes used for the small (5-1/4-inch) 
flexibie disks used with the Apple Disk II drive. 

Disk II drive: A model of disk drive made and sold by Apple 
Computer for use with the Apple lie computer; uses 5-1 /4-inch 
flexible ("floppy") disks. 

Disk Operating System: An optional software system for the 
Apple lie that enables the computer to control: and communicate 
with one or more Disk 91 drives, 

display: (1 ) Information exhibited visually, especially on the 
screen of a display device. (2) To exhibit information visually. (3) 
A display device. 
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dIspJay device: A device that exhibits information visually, such 
as a television receiver or video monitor. 

display screen: The glass or plastic panel on the front of a 
display device, on which images are displayed. 

DOS: See Disk Operating System 

dual in-lme package; An integrated circuit packaged In a narrow 
rectangular box with a row of metal pins along each side; similar 
in appearance to an armored centipede. 

edit: To change or modify; for example, to insert, remove, 
replace, or move text in a document. 

editor: A program that enables the user to create and edit 
informatiori of a particular form, for example, a text editor or a 
graphics editor. 

effective address: In machine-language programming, the 
address of the memory location on which a particular instruction 
actually operateSr which may be arrived at by indexed addressing 
or some other addressing method. 

error message: A message displayed or printed to notify (h© 
user of an error or problem in the execution of a program. 

escape mod e: A s tate of the Apple He computer, entered by 
pressing the [escJ key, m which certain keys on the keyboard 
take on special meanings for positioning the cursor and 
controlfing the display of text on the screen. 

escap e sequence: A sequence of keystrokes beginning with the 
I ESC I key, used for positioning the cursor and controlling the 
display of text on the screen. 

exclusive QR: A logical operator that produces a true result if 
one of its operands is true and the other false, a fafse result if its 
operands are both true or both false; compare QRi and, HOT. 

execute: To perform or carry out a specified action or sequence 
of actions, such as those described by a program. 

expansion slot: A connector inside the Apple He computer in 
which a peripheral card can be installed; sometimes called 
peripheral slot. 

firmware: Those components of a computer system consisting of 
programs stored permanently in read-only memory. Such 
programs (for example, the Applesoft interpreter and the Apple 
lie Monitor program) are built into the computer at the factory; 
they can be executed at any time but cannot be modified or 
erased from main memory. Compare hardware, software. 
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fixed-point: A method of representing numbers inside the 
computer in which the decimal point (more correctiy, the binary 
pofnt) is considered to occur at a fixed positron within the 
number. Typically, the point is considered to lie at the right end 
of the number, so that the number is interpreted as an integer. 
Compare floating-point. 

flexible disk: A disk made of flexible plastic; often called a 
"floppy" disk. Compare rigid disk, 

floating-point: A method of representing numbers inside the 
computer in which the decimal point {more correctly, the binary 
point) is permitted to "float ' to different positions within the 
number Some of the bits within the number itself are used to 
keep track of the point's position. Compare fixed-point, 

GAME lyo connector: A special 16-pin connector inside the 
Apple He, originally designed for connecting hand controls to the 
computer, but also used for connecting some other peripheral 
devices. Compare hand control connector. 

graphics: (1 ) Information presented in the form of pictures or 
images. {2) The display of pictures or images on a computer's 
display screen. Compare teKt. 

hand control: An optional penpheral device that can be 
connected to the Appie He's hand control connector and has a 
rotating dial and a pushbutton; typically used to control game- 
playing programs, but can be used in more serious applications 
as well. 

hand control connector: A 9-pin connector on the Apple lie's 
back panel, used for connecting hand controls to the computer. 
Compare GAME I/O connector. 

hardware: Those components of a computer system consisting 
of physical (electronic or mechanical) devices. Compare 
software, firmware, 

hertz: The unit of frequency of vibration or oscillation^ also called 
cycles per second; named for the physicist Heinrich Hertz and 
abbreviated Hz. The current provided by a standard power outlet 
alternates at a rate of 60 hertz; that is , it changes polarity 60 
times each second. The Apple He's 6502 microprocessor 
operates at a clock frequency of 1 million hertz, or 1 megahertz 
(MHz). 
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hexadecimal: The representation of nymbers in terms of 
powers of sixteen, using the si>rteen digits to 9 and A to F 
Hexadecimal nunnbers are easier for humans to read and 
understand than binary numbers, but can be converted easily 
and directly to binary form: each hexadecimal digit corresponds 
to a sequence of four binary digits, or bits. 

high-level language: A programming language that is relatively 
easy for humans to understand. A single statement in a high- 
levei language typically corresponds to several instructions 0I 
machine language. 



high-order byte: The more significant half of a memory address 
or other two-byte quantity. In the Apple lie's 6502 
microprocessor, the low-order byte of an address is usually 
stored first and the high-order byte second. 

high-resolution graphics: The display of graphics on 

the Appie lie's display screen as a six-color array of points, 280 

columns wide and 192 rows high. 

hold time: In computer circuits, the amount of time a signal 
must remain valid after some related signal has been turned off, 
compare setup time. 

Hz: See hertz. 

IQ: See Integrated oircult. 

information: Facts, concepts^ or instructions represented in an 
organized form, 

index: (1 ) A number used to identify a member of a list or table 
by its sequential position. (2) A list or tabEe whose entries are 
identified by sequential position. (3) In machine-language 
programming, the variable component of an indexed address, 
contained in an index register and added to the base address to 
form the effective address. 

indexed addressing: A method of specifying memory addresses 
used in machine-language programming. 

index register: A register in a computer processor that holds an 
index for use in indexed addressing. The Apple lle^s 6502 
microprocessor has two index registers, called the x register and 
the V register. 

input: (1 ) Information transferred into a computer from some 
externaE source, such as the keyboard, a disk drive, or a modem. 
(2) The act or process of transferring such information. 



Glossary 



239 



instruction: A unit of a machine-language or assembly-language 
program corresponding to a single action tor the computer's 
processor to perform. 

Integer: A whole number, with no fractional part; represented 
inside the computer in fixed-point form. Compare real number. 

integrated circuit: An electronic component consisting of many 
circuit elements fabricated on a single piece of semiconducting 
material, such as silicon; see chip. 

Interface: The devices, rules, or conventions by which one 
component of a system communicates with anotlier. 

interface card: A peripheral card that implements a particular 
interface {such as a parallel or serial interface) by which the 
computer can communicate with a peripheral device such as a 
printer or modem. 

interpreter: A language translator that reads a program written 
in a particular programming language and immediately carries out 
the actions that the program describes. Compare compiler 

Interrupt: A temporary suspension in the execution of a program 
by a computer in order to perform some other task, typically in 
response to a signal from a peripheral device or other source 
external to the computer. 

inverse video: The display of text on the computer's display 
screen in the form of biack dots on a white (or other single 
phosphor color) background, instead of the usual white dots on a 
black background. 

I/O: Input/output; the transfer of information into and out of a 
computer. See input, output. 

I/O device: Input/output device; a device that transfers 
information into or out of a computer. See input, output 
peripheral device. 

I/O link: A fixed location that contains the address of an input/ 
output subroutine in the Apple lie Monitor program. 

K: Two to the tenth power, or 1024 (from the Greek rooi kifo, 
meaning one thousand); for example, 64K equals 64 times 1024, 
or 65,536. 

keyboard: The set of keys built into the Apple lie computer, 
similar to a typewriter keyboard, for typing information to the 
computer. 

keystroke: The act of pressing a single key or a combination of 
keys (such as [ cdhtrdl j -C) on the Apple lie keyboard. 
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kilobyte: A unit of information consisting of 1K (1024) bytes, or 

eK (8192) bits: see K. 

KSW: The symbolic name of the locatfon in tfie Apple lie's 
memory whiere tf>e standard fnput link is stored; stands for 
"keyboard switch." See f/0 link. 

language: See programming language. 

language translator: A system program that reads a program 
written in a particuiar programming language and eilfier executes 
it directly or converts it into some other language {such as 
machine language) for later execution. See interpreter, 
compiler, assembler. 

load: To transfer information from a peripheral storage medium 
[such as a disk) into main memory for use; for exampie, to 
transfer a program into memory for execution. 

location: See memory location. 

logical operator: An operator, such as i^ND, that combines 
logical values to produce a logical resuft, 

low-level language; A programming language that Is reiatively 
close to the form that ihe computer's processor can execute 
directly. Low-level languages available for the Apple fie include 
6502 machine language and 6502 assembly ianguage, 

low-order byte: The less significant half of a memory address or 
other twO'byte quantity. In the Appie lie's 6502 microprocessor, 
the low-order byte of an address is usually stored first and the 
high-order byte second. 

low-power Shottkey: A Type of TTL integrated circuit having 
lower power and higher speed than a conventional TTL 
integrated circuit 

low-resolution graphics; The display of graphics on the 
Appie lies dfaplay screen as a sixteen-color array of blocks, 
40 coiumns wide and 48 rows high. 

LS: See low-power Shottkey, 

machme language: The form in which instructions to a 
computer are stored in memory for direct execution by the 
computer's processor Each model of computer processor [such 
as the 6502 microprocessor used in the Apple Ne) has its own 
form of machine language. 
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mode: A state of a computer or system that determines its 
behavior. 

modem: Modulator/demodulator; a peripheral device that 
enables the computer to transmit and receive irtformation over a 
telephone line. 

modulate: To modify or alter a signal so as to transmit 

information; for example, conventionai broadcast radio transmits 
sound by modulating the amplitude (amplitude modulation, or 
AM) or the frequency (frequency modulation, or Ffvl) of a carrier 

signai. 

monitor: See video monitor 

Monitor program: A system program built into the Apple Ha in 
firmware, used for directly inspecting or changing the contents of 
main memory and for operating the computer at the machine- 
language level. 

nanosecond: One billionth (in British usage, one thousand- 
millionth) of a second; abbreviated ns. 



2 



main memory; The memory component of a computer system 
that is built into the computer itseit and whose contents are 
directiy accessible to the processor. 

memory: A hardware component of a computer system that can I 

store information for later retrieval; see main memory, random- I 

access memory, read-only memory, read-wrile memory, 
write-only memory 

memory location; A unit of main memory that is identified by 
an address and can hold a single item of information of a fixed 
size; in the Apple Me. a memory location holds one byte, or eight 

bits, of information. 

memory-resident: (1) Stored permanently in main memory, as I 

firmware. (2) Held continually In main memory even while not in ^ I 

use, as the Di^k Operating System. 

MHz: Megahertz; cne million hertz. See hertz. 

microcomputer: A computer, such as the Apple Me, whose 

processor is a microprocessor. 

microprocessor: A computer processor contained in a single 
integrated circuit, such as the B5Q2 microprocessor used in the 
Apple lie. 

microsecond: One mlilionth of a second; abbreviated fxs. 
mHlisecond: One thousandth of a second; abbreviated ms. 
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network: A collection of interconnected, individually controlled 
computers, together with the hardware and software used to 
connect them. 

nibble: A unit of information equal to half a byte, four bits, or 
fifty cents; can hold any value from to IB, Sometimes spelled 

nybble. 

NOT; A unary logical operator that produces a true result if its 
operand is false, a false result if its operand is true: compare and, 
OR, «?Kclu3ive OR. 

NTSC: (1) National Tefevision Standards Committee; the 
committee that defined the standard format used for transmitting 
broadcast video signals in the United States. (2) The standard 
video format defined by the NTSC 

object code: See object program. 

object program; The translated form of a program produced by 
a language translator such as a compiler or assembier; also 
called object code. Compare source program. 

op code: See operation code. 

operand: A value to which an operator is applied. 

operating system: A software system that organises the 
computer's resources and capabilities and makes them available 
to the user or to application programs running on the computer. 

operation code: The part of a machine-ianguage instruction that 
specifies the operation to be performecf; often called op code. 

operator: A symbol or sequence of characters, such as + or and, 
specifying an operation to be performed on one or more values 
(the operands) to produce a result. 

OR: A iogical operator that produces a true result if either or both 
of its operands are true, a false result if both of its operands are 
false; compare exciuaive OR, and, not. 

output: (1 ) Information transferred from a computer to some 
external destination, such as the display screen, a disk drive, a 
printer, or a modem, (2) The act or process of transferring such 
information. 

page: (1) A screenfuf of information on a video display, 
consisting on the Apple lie of 24 lines of 40 or 80 characters 
each, (2) An area of main memory containing text or graphical 
information being displayed on the screen. (3) A segment of main 
memory 256 bytes long and beginning at an address that is an 
even multiple of 256 bytes. 
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page xero: See zero page. 

parallel interface: An interface in which many bits of information 
(typicaJly eight bits, or one byle) are transmitted Sfmultaneously 
over different wires or channels. Compare serial Interlace. 

PC board: See printed-circuit board. 

peripheral: At or outside the boundaries of the computer Itself. 
either physically (as aperipheraf device) or in a logical sense 
(as a peripheral card). 

peripheral bus: The bus used for transmitting information 
between the Apple lie computer and peripheral devices 
connected to the computers expansion slots. 

peripheral card: A removable printed-circuil board that plugs 
into one of the Apple lie's expansion slots and expands or 
modifies the computer's capabilities by connnecting a peripheral 
device or performing some subsidiary or peripheral function. 

peripheral device: A device, such as a video monitor, disk 
drive, printer, cr modem, used in conjunction with a computer. 
Often (but not necessarily) physically separate from the computer 
and connected to it by wires, cables, or some other form of 
interface, typically by means of a peripheral card. 

peripheral sloti See expansion slot. 

phase: (1 ) A stage in a periodic process; a point in a cycle; for 
example, the 6502 microprocessor uses a clock cycle consisting 
of two phases called i^O and i^l . (2) The relationship between 
two periodic signals or processes; for example, in NTSC color 
video, the color of a point on the screen Is expressed by the 
instantaneous phase of the video signal relative to the color 
reference signal. 

pipelinings A feature of a processor that enables it to begin 
fetching the next instruction before it has finished executing the 
current instruction. All other things equal, processors that have 
this feature run faster than those without it. 

pointer: An item of information consisting of the mennory 
address of some other item. 

pop: To remove the top entry from a stack. 

port: The paint of connection, usually a physical connector, 
between a computer and a peripheral device, another computer, 
or a network. 
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power supply: The hardware component of a computer that 
draws electrical power from a power outlet and converts ft to the 
forms needed by other hardware components, 

printed'drcuit board: A hardware component of a computer or 
other electronic device, consisting of a Hat, rectangular piece of 
rigid malehal, commonly fiberglass, to which integrated circuits 
and other electronic components are connected. 

printer: A peripheral device that writes informatfon on paper in a 
form easily readable by humans or literate monkeys. 

processor; The hardware component of a computer that 
performs the actual compulation by directly executing instructions 
represented in machine language and stored in main memory. 

program: (1) A set of instructions describing actions for a 
computer to perform in order to accomplish some task, 
conforming to the rules and conventions of a particular 
programming language. {2) To write a program 



programming language: 

writing programs. 



A set of rules or conventions for 



prompt: To remind or signal the user that some action is 
expected, typically by displaying a distinctive symbol, a reminder 
message, or a menu of choices on the display screen. 

prompt character: A text character displayed on the screen to 
prompt \he user for some action. Often aJso identifies the 
program or component of the system that is doing the prompting; 
for example, Ihe prompt character : fs used by the Applesoft 
BASIC interpreter, > by Integer BASIC, and • by the system 
Monitor program. Also caWeti prompting character. 

prompt message: A message displayed on the screen to 
prompt the user for some action. Also called prompting 
message. 

push: To add an entry to the top of a stack. 

radio-frequency modulator: A device for converting the video 
signals produced by a computer to a form that can be accepted 
by a tefevision receiver. 

RAM: See random-access memory. 

random-access memory: Memory in which the contents of 
individual locations can be referred to in an arbitrary or random 
order- This term is often used incorrectly to refer to read-write 
memory, but strictly speaking both read-only and read-write 
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memory can be accessed in random order. This misuse of the 
term random-access is an attempt to confuse new users, 
creating a rite of passage and an excellent market for glossaries 
of computer terms. Compare read-only memory, read-write 
memory, write-only memory. 

raster: The pattern of parallel lines making up the image on a 
video display screen. The image is produced by controlling the 
brightness of successive dots on the individual lines of the rastern 

read: To transfer information into the computer's memory from a 
source external to the computer (such as a disk drive or modem) 
or into the computer's processor from a source external to the 
processor (such as the keyboard or main memory). 

read-only memory; Memory whose contents can be read but 
not written; used for storing firmware, information is written Snto 
read-only memory once, during manufacture; it then remains 
there permanently, even when the computer's power is turned 
off, and can never be erased or changed. Compare read-write 
memory, random-access memory, write-only memory 

read*-write memory: Memory whose contents can both be read 
and written; often misleadingly called random-accsss mefrtory, or 
RAM. The information contained in read-write memory is erased 
when the computer's power is turned off, and is permanentiy lost 
unless it has been saved on a more permanent storage medium, 
such as a disk. Compare read-only memory, random-access 
memory, write-only memory, 

real number: A number that may include a fractional part; 
represented inside the computer in floating-point form. Compare 
integer. 

register: A location in a computer processor where an item of 
information, such as a byte, is held and modified under program 
control. Registers in the 6502 microprocessor inciude the 
accumulator (A), two index registers {y. and Y), the stack pointer 
{S)> the processor status register (P), and the program counter 
(PC), The PC register holds two bytes (sijtteen bits); the other 
registers hold one byte (eight bits) each, 

return address: The point in a program to which control returns 
on completion of a subroutine. 

RF modulator: See radio-frequency modulator. 

rigid disk: A disk made of a hard, nonflexible materiaL Compare 
flexible disk. 
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ROM: See read-only memory. 

routine: A part of a program that accomplishes some task 
subordinate to the overall task of the program. 

run: (1) To execute a program. (2) To load a program into main 
memory from a periphieral storage medium, such as a disk» and 
execute It 

SAve: To transfer anformation from main memory to a peripheral 
storage medium for later use. 

screen: See display screen. 

scroll: To change the contents of all or part of the display 
screen by shifting information out at one end (most often the top) 
to make room for new information appearing at the other end 
(most often the bottom), producing an effect like that of moving a 
scroll of paper past a fixed viewing window. See viewport, 
window. 

serial interface: An interface in which information is transmitted 
sequentially, one bit at a time, over a single wire or channel. 
Compare parallel Interface. 

setup time: The amount of time a signal must be valid in 
advance of some event; compare hold lime. 

silicon: A non-metallic, semiconducting chemical element from 
which integrated circuits are made, Not to be confused with s/lica 
— that is. silicon dioxide, such as quartz, opal, or sand — or 
with silicone, any of a group of organic compounds containing 
silicon 

soft switch: A means of changing some feature of the Apple !le 
from wilhin a program; specifically, a location in memory that 
produces some special effect whenever its contents are read or 
written. 

software: Those components of a computer system consisting of 
programs that determine or control the behavior of the computer. 
Compare hardware, firmware. 

source code: See source program. 

source program: The original form of a program given to a 
language translator such as a compiler or assembler for 
conversion into another form; sometimes called sowfoe code. 
Compare object program. 

space character: A text character whose printed representation 



is a blank space, typed from the keyboard by pressing the [s PACE] 
bar. 
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stack: A Jist In which entries are added or removed at one end 
only (the top of the stack), causing them to be removed in LIFO 
(last-infirst-out) order. 

string: An item of information consisting of a sequence of text 

characters. 

strobe: (1) An event, such as a change tn a signal, that triggers 
some action. (2) A signal whose change is used to trigger some 
action. 

subroutine: A part of a program that can be executed on 
request from any point in the program, and which returns control 
to the pornt of the request on completion. 

system: A coordinated collection of interrelated and interacting 
parts organized to perform some function or achieve some 
purpose. 

television receiver: A display device capable of receiving 
broadcast video signals (such as commercial television) by 
means of an antenna. Can be used in combination with a radio- 
frequency modulator as a display device for the Apple IJe 
computer. Compare video monitor. 

television set: See television receiver. 

terminal: A device consisting of a typewriterlike keyboard and a 
display device, used for communicating between a cornputer 
system and a human user. Personal computers such as the 
Apple He typically have all or part of a terminal built into them. 

text: (1 ) Information presented in the form of characters readable 
by humans. (2) The display of characters on the Apple lies 
display screen. Compare graphlcs^ 

text window: An area on the Apple lie's display screen within 
which text is displayed and scrolled. 

transistor-transistor logic; (1 ) A family of integrated circuits 
used in computers and related devices. (2) A standard for 
interconnecting such circuits that defines the voltages used to 
represent logical zeros and ones. 

troubleshoot: To locate and correct the cause o1 a problem or 

malfunction in a computer system. Typically used to refer to 
hardware-related problems; compare debug. 

TTL; See transistor-transistor logic. 

unary operator: An operator that applies to a single operand; 
for example, the minus sign (-) in a negative number such as -G 
is a unary arithmetic operator. Compare binary operator. 
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user: The person operating or controlling a computer system. 


E - 


user interface: The rules and conventions by which a computer 
system communicates with the person operating it. 


^^^^^^j 


vector: (1) The starting address of a program segment, when 
used as a common point for transferring control from other 
programs. (2) A memory location used to hold a vector, or the 
address of such a location. 


E^ 


video: (1 ) A medium for transmitting information in the form of 
images to be displayed on the screen of a cathode-ray tube. (2) 
Informatron organized or transmitted in video form. (3) An early 
space pioneer. 


^K*^ 


video monitor: A display device capable of receiving video 
signals by direct connection only, and which cannot receive 
broadcast signals such as commerciai television Can be 
connected directly to the Apple Me computer as a display device. 
Compare television receiver. 


^^^^ 


vJewport: AH or part of the display screen, used by an 
application program to display a portion of the information (such 
as a document, picture, or worksheet) that the program is 
working on. Compare window. 




warm start: The process of restarting the Apple He after the 
power is already on, without refoading the operating system into 
main memory and often without losing the program or Information 
already in main memory. Compare cold start. 




window: (1) The portion of a collection of infom^ation (such as a 
document, picture, or worksheet) that is visible in a viewport on 
the display screen; compare viewport. (2) A viewport (3) A flat. 
rectanguiai' panel, usually made of silica, used in many archaic 
structures as a human-to-nature interface. 
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word: A group of bits of a fixed size that is treated as a unit; the 
number of bits in a word is a characteristic of each particular 
computer. 


E^ 


wraparound: The automatic continuation of text from the end of 
one line to the beginning of the next, as on the dlspiay screen or 
a printer. 


E^ 


write: To transfer information from the computer to a destination 
external to Ihe computer [such as a disk drive, pnnter, or 
modem) or from the computer's processor to a destination 
external to the processor (such as main memory). 


K^ 
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write-only memory: A form of computer memory into which 
information can be stored but never, ever retrieved, developed 
under government contract in 1975 by Professor Homberg T. 
Farnsfarfle. Farnstarfles ohginal prototype, approximately one 
inch on each side, l~ias so far been used to store more than 100 
trillion words of surplus federal information. Farnsfarfte s critics 
have denounced his project as a si x-miH ion-dollar boondoggle, 
but his defenders point out that this excess information would 
have cost more than 250 billion dollars to store in conventional 
media. Compare read-only memory, read-write memory, 
random-access memory. 

X register: One of the index registers in the 6502 

microprocessor. 

Y register: One of the Index registers in the 6502 
microprocessor. 

zero page: The first page (256 bytes) of the Apple lie s memory, 
also called page zero. Since the Ngh-order byte of any address 
in this page is ^ero, only the low-order byte is needed to specify 
a zero-page address; this makes zero-page locations more 
efficient to address, in both time and space, than locations in any 
other page of memory. 



a 
"J 



250 



Qlotsary 



i 

J 





H 



J 

"J 





] 












-4 


Bibliography 




L^ 


Bibliography 






Apple Computer, Inc.; >^pp^e He Applesoft Reference Manual: 
Apple Computer Inc., 1982. Cupertino, CA Apple product number 
A2L2004 


E^ 


— Apple He Applesoft Tutorial Manaaf; Appte Computer Inc., 
1982, Cupertino, CA. Apple product number A2L2003 


E II 


— Apple If BASIC Programming Manual; Apple Computer Inc., 
1978, Cupertino, CA. Apple product number A2L0005 




^ 


— Apple If Monitors Peeled; Apple Computer Inc.. 1978. 
Cupertino, California. Apple product number D2L0013 




-1 


— Apple fte Owner's Manual; Apple Computer Inc., 1962, 
Cupertino, CA. Apple product number A2L2001 

— Programmer's Aid #7 tnstalfation and Operating Manual; 
Apple Computer Inc., 1978, Cupertino, Calrfornia, Apple product 
number A2L001 1 

Leventtial, Lance: 6502 Assembly Language Programming; 
Osborne/McGraw-Hill, 1979. Berkeley, CA 




Synertek, Incorporated: Wsrrfw^a/'e Manual: Synartek Incorporatedp 
1976, Santa Clara, CA Apple product number A2L0002 




— Programming Manual; Synertek Incorporated. 1976, Santa 
C!ara, CA. Apple product number A2L0003 




^ 


Watson, Allen, 111: "More Colors for Your Apple"; &yte. Vol, 4, 
No. 6, June, 1979. Byte Publications. Inc. Peterborough, NH 




T 


^ "Simplified Theory of Video Graphics, Part 1"; Byte, Vol. 5. 
No. 11, November, 1980. Byte Publications, Inc, Peterborough, 
NH 




:^ 


Bibliography 253 



— "Simplified Theory oi Video Graphics, Part H"; Byte, Vol. 5, 
No. 12, December, 1980. Byte Publications, tnc. Peterborough, 
NH 

Wozntak. Steve: "System Description: The Apple 11"; Byte. Vol. 2. 
No. 5. May. 1977. Byte Publications, Inc. Peterborough, NH 

— "SWEETie: The 6502 Dream Machine"; Byte, Vol. 2, 

No, 10. October. 1977. Byte Publications, Inc, Peterborough, NH 



i 

a 

'i 

a 



25^ 



Bibliography 



4 
4 
1 



Index 



Index 



A 

Ai 77-8 
A1H 77 
ftIL 77 
A£ 77-e 
A£H 77 
A£L 77 
ft4 77-8 
A4H 77 
A^L 77 

absolute address lOB 
accumulator 54, 78-9. 126-6, 
140, 185, 187 

ADC 1 88 

addition 1 03 

address bus 6, 35, 140, 142, 

1 69-70 
address decoding, I/O 164 
address space 63. 140, 148 
addresses 

absolute lOB 

base 64, 126-129 

in Monitor commands SB 

Mini-assembler 113 

multiplexed 151 

RAM 151 

relative 108, 114. 126 
addressing, relative 10B, 114, 

126 
addressing, zero-page 113 

ALTCHARSET SOft Switch 20. 28. 

45, 145 
alternate character set 19-21. 45. 

52-4, 156 
fiLTzP soft switch 74-7, 143 
analog inpyl memory locations 40 
analog input reset 40 
analog inputs 37. 39, 167 
AND function 52 
AND instruction 188 
annunciator memory locations 40 



annundalors 35, 37, 79, 164» 

167 
Any-l<ey-down 15, 164 
Any-key-down flag 13, 15 
Apple II 

cfiaracter sets 20 

compatibility 76 

GETLH 58 

making lie resemble 44 

memory use 68 
Apple H BASiC Programming 

Manual 13 
Apple II Plus 

cfiaracter sets 20 

compatibility 76 

cursor-motion keys 56 

Oe:tln 56 

making Ills resemble 44 

memory use 68 

reset 70 
Apple keys 12, 17, 38. 40 
Apple Mini-assembler 57, 110-14 
Applesoft BASIC 

and bank-switched memory 68 

and page zero 64, 66, 92 

and reset rotitine 80 

and I/O subroutines 43 

decimaf addresses with 13. 27 

interpreter 6. 148 

prompt 57 

relurnif>g to 102 

statements 45 
Applesoft Reference Manual 6 
Applesoft Tutorial 6, 56 
arrow keys 12, 58 
ASCII codes 12-17.'21 
ASCfi character set 5. 16, 19 
ASL 188 

assemblers 10S, 110 
Assembler/Editor 110 



Index 



257 





^^^^^^^1^1 


^m^^^^^^^^^^^^H 


^^^^^^^^^^^1 


■1 






assembly language 


BASIC, Applesoft 








and AUXMDVE 77 


see Applesoft BASfC 








and bank switching 70 


BASIC, Integer 


g= 






and display pages 29 


see Integer BASIC 
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and indirect addressing 64 


BCS 1S8 


^ 


I 


and machine ianguage 108-9 


BEQ 188 




and standard subroutines 43 


BELL subroutine 36 






hexadecimai addresses with 13 


BIT 1 se 






prompi character 57 


bit patterns, high-resolution 161 


^ 




with Miniassembler 110-113 


bit, high-order 




asterisk 57, 87 


see high-order bit 






audio cassettes 36, 9B 


bit mapped 24 






automatic repeat 1 1 


black-and-wlnite monitor 24 


^ 




Autostart Monitor 47 


blanking intervals 153 




auxiliary mennofy 26h 30, 71-78 


blanking, horizontal 153 






auxiliary RAM 63. 71.79 


blanking, vertical 154 


g3 




ausciliary slot 7, 21, 71 


blinking cursor 43, 54, 87, 110 




and reset routine 79 


BMl 188 




and slot 3 46, 123 4, 132-3 


ENE IBS 






signals 174-5 


bootstrap 80 


i^ 




aLrxlliary-meniory subroutines 76 


borrow 1 85 




auxiliary-RAM enable signals 175 


BPL 188 






fiUXMOVE subroutine 76-8 


BRK 97, 10S, 140, 1S8 


6= 




B 


BR< requests 82 
brk: vector 131 




back panel 8 


buffer, bus 170 






backspace 58 


buffer, inpyt 56-8. 64, 106 


g= 




backspace character 58 


buffers, display 24, 65 




bandwidth 17 


buffers, three-slate 170 






bank switches 69 


built-in BO-column firmware 






bank switching BB-71 


see BO-column Itrmware 


^ 




bank-switched memory 68-72. 


built-in subroutines 76-78 




73-4 


bus buffer 170 






and reset 79 


bus, address 6. 35, UO. 142. 


^ 




bank-switched HAM 68-70. 74, 


16S, 170 




BO. 110 


bus, data 170 




base addresses 64, 126-129 


BVC 1 88 






BASIC 


BVS 1 B9 


^ 




and auxiliary memory 71 






and GETLN 56-7 


c 






and I/O 103, 129-30 






and reserved memory 7t 


CfiLL -151 S7, 110, 112 


g: 




and soft switches 29 


cancel line 53 






and stop-lisi mode 50 


CAPS LOCK key 13. 13. 17, 44, 






and (aping data 37 


58 


sz 




and zero page 64 


card, language SB, 70. 121 




compared lo maclnine 


cardSr peripheral see peripheral 






language 107 


cards and 80-column text card 






tnvoking Monitor from 87 


carry bit 77. 78„ 187 


B?* 




reading analog inputs 40 


CftB 151 


IM 




reading switch input 38 


cassette f/O 11. 35-6, 40. 98, 






returning to from Mini- 


164, 166 






assembler 112 


cassette recorder 8. 36, 166 


id 




returning to from Monitor SB, 


central processing unit 6, 140, 


c* 




102 


143, 151 


fC 
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Si* 





Eji 


CH 50-1 


CDNTRDL key 12, 13, 17. 50. 164 


^M 


character generator 158-62 


CONTROL - OPEN-flPPLE - RESET 


^S^r4 


Characler ouiput Switch 48,129, 


81 


^Ha-^ 


130 


CDNTRDL -S 102. 116 


^H 


characler set. atiernate 1 9-21 , 


CDNTRDL -C SO, 88, 102, 116 


^^^ 


45, 52-4, 158 


CDNTRDL -D 130 


^^^1 


cbaraclfif set. ASCII 5, 16, 19 


CDNTRDL -E 116 


^^^^ 


character set, primary 19-21, 45, 


CDNTRDL -K 103, 130 


^1 


53, 79, 158 


CDNTRDL - OPEN-APPLE - RESET 


^^^^^ 


character sets 19 


SI 


^M^JI 


characters, lowercase 20. 44, 53 


CDNTRDL -P 46 ,102, 117 


^B 


characters, uppercase 20. 44. 53 


CDNTRDL ' RESET 79-61, SB 


^1 


checksum 99. 100 


caWTRDL -S 50 


^■"li 


circuit board, main 6, 37. 121, 


CDNTRDL - SOLtD-APPLE - 


^5~i 


139, 169, 174 


RESET 


^1 


circuit, protection 139 


81 


^^L__ 


circuits, I/O 164-168 


CONTROL -U 46 


^^^_jl 


circumflex 111, 114 


CDNTRDL -¥ 106 


^^1^ 


CLC 189 


controller card, disk drive 80 


^1 


CLD 189 


counter, horizontal 153, 155 


^^^ 


clear-strobe switch 13 


counter, program 109, 111 


^Kfc^j 


CLEOLZ 46 


counter, verttcai 153, 155 


^H 


CLI 189 


counters, video 153, 157 


^^^ 


clock 1 4 1 


CDUT 43, 46, 47, 58, 101 


^^^ji 


clock rate 140 


C0UT1 47-63, 57, 129^ 


^S~! 


clock signals 141, 142 


130 


^1 


CLftEDL 46 


cover 4 


^^^^ 


CLREDP 46 


CPU 6, 140, 143, 151 


^p^d 


CLRGfiT' 146. 177 


CPX 189 


^B ^^ 


CLV 189 


CPV 189 


^1 


CP1P 1B9 


CSW 48. 129, 130 


^^"^ 


Codes, hex operation 194 


CEWH 129 


^^1^ 


codes, intruclcon 188-192 


CSWL 129 


^1 


cold-start reset 80 


currents, supply 138 


^^^^_ 


colon [in Monitor comrnands) 93, 


cursor 


^^^^n 


115 


blinking 43, 54, 67, 110 


^■"^ 


color rronitor 24, 25, 160 


checkerboard 43, 110 


^1 


color signal 16D-2 


motion 56 


JL— 


color television set 24, 160 


plus sign 56 


^mj^ 


coJor television. NTSC 25 


position 49-51, 57, 79 


^H 


color-bLrrsI gale 153 


cursor control keys 12. 55, 56 


^B^^ 


colors 22 


CV 50, 51 


^£^5 


high-resolution 24-5, 161 


cycle stealing 149 


^^p"^ 


low- resolution 23, 160 




^1 


Column address Strobe 151 


D 


^^^^^ 


command chafaders 88 


D-type miniature connector 37, 


P^LmJ 


complementary decimal 13 


167 


^H 


composite video 17, 163 


daisy chain, priority 170 


^H 


connectors [see also slots) 


data bus 170 


^5^^ 


D-type miniature 37, 167 


data str6be 37. 167" 


B5^^ 


for cassette recorder 8 


debounce 164 


bh 


for hand^contfolfi 8, 37, 167 


DEC 789 


^^L^ 


for video monitor S 


decfmal 13, 27 


^E13 


constant, time 39 


decimal, complementary 13 


^^i*^ 


caNTiNUE BASIC command 102 


decoder, keyboard character 6, 


■^ 


control characters 50 


13, 149, 154 


■ 
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SELECT' 122,169.174 expansion slot 3 45.46,79 
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DEVICE 

DEX 18& 

DEy 189 

Diagnostics ROM 14S 

direcl-mennory access signai 170 

disassembief 108 

disk drive controller card 80 

Disk Operating System see DOS 

display, video 11, 17-34, 152-62 

ao-colunnn 46. 159, 175 

buffefs 65 

display mgmory 1 54 

display mode 27 

display pages 2G-30, 65, 
72. 74 

forina(s 1 9-20, 52-3 

flashing format 19-20, 44, 52-3 

high-resolution 161 

inverse 19-20, 46. 52-3, 101 

iow-resolytion 160 

mixed mode 19. 27 

normal 19-20, 52-3. 101 

soft switches 2S 
DMA IN 170 
DMA DUT 170 
DMA' 144. 169-170 
DOS 

and reset 80 

and Monitor 87, 102 

1/0 links 47, 130 

link address storage 65 

page zero usage 64, 67, 92 

RAW addressing 129 
DOS Manual &5, SO. 81. 130 
DOS Tool Kit 110 

DOUN-ARi^OM 12 

dynamic RAM 143. 145, 149, 151 

E 

editing 58 
EIA 163 

Eiectronic Induslries 
Association 1 B3 
EM80' 144, 175, 177 
environmental specificalions 137 
EOR 190 
E Rff 1 00 
error message 83 
errors 111 
ESC key 12. 13, 54, 56 

ESC COHTHQL -Q 4B 

escape codes 55 
escape mode 56 
EXAMINE command 98 

piclu5iue-nR 81. 82 

expansion ROM 123-125 
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7, 



21 33. 



expansion slots 

169-174 
extended 80-column text card 71 

F 

FGG6G 111, 117 
FFG9G 1:12, 117 

firmware [see also SO^column 

firmware) 

built-in I/O 43-58 

on peripheral cards 121 
flashing display format 19-20, 44. 

52-3 
flip-flop 124 

forced cold-start reset 79, 81 
format, inverse 19-20, 46, 

52-57. 101 
FP 47 
functions 

AND 52 

Stop-list 50 



G (Monitor command) 117 

Game l,'0 1 67 

GAME I/O socket 168 

game inputs 37. 167 

gate^ color-bursi 153 

GETLN 43, 53, 56-B, 64. B8 

00 command 97, 102, 107. Ill 

QOtoXY 49 

GR 147, 174. 178 

graphics 22-34 

high -resolution 18-19. 23-5, 29, 
161 

low-resolulion 18-19, 22-3. 160 

mixed-mode 27 
grounded outlet 138 

H 

hand controls 8, 37, 167 
hand-control connector 37 
hand-control input 35. 167 
Hardware Manual 141 
hex operation codes 194 
hexadecimal 13, 14, 23, 27, 61, 

83, 113 
hexadecimal arithmetic 103 
high-level languages 29, 43, 

107 (see a^so names of 

languages) 
high-order bit 

and cassette I/O 37 

and color determination 
24-5, 162 



i 

II 

a 

'J 



?d 







and display format 53 


Instructions. 6502 186 




and state ol soft switches 29, 36 


IHT 47, 110 




of switch input byie 38 


IHT IN 131. 170 




high- resolution bit patterns 161 


INT OUT 131, 170 




high-resolytion graphics 18-19, 


INTBASIC 110 




23-5, 29. 161 


1NTC3RDM soft switch 46 




high-resolution graphics 


Integer BASIC 




colors 25, 161 


and bank-switched mernory 68 




high-resolution Page 1 24, 30, 


and the Miniassembler 1 1 




65. 74 


and the old Monitor 47 


^^^^-^ 


high-resolution Page 2 24. 30, 65 


and RDK£Y 54 




HIRES sort switch 28, 74-5, 143, 


and reset routine 70. 80 




145 


and standard I/O 




HOME 46 


subroutines 43 




horizontal blanking 153 


complementary decimal 




hohzontal counter 153. 155 


with 1 3, 27 




horizontal sync 153 


page zero usage 64, 67 




I 


prompt character 57 




returning to 1G2 




I (Monitor command) 1)6 


statements 45 




1,^0 


Integrated circuft 6 




addre&s decoding 164 


interlace 1 3 




buiit-in devices 11-41 


interpreter, Applesoft BASIC 6 




buiil-in firmware 43-58 


Interpreter, Integer BASIC 110 




circuits 1 68 


interrupt handler 131 


^^^k 


drivers 121 


interrupt priority 131 




links, standard 46. 79, 


interrupt requests 131, 170 




129-130 


interrupt vectofs S1-2, 131 




memory locations 122, 132 


interrupt- handling routine 1 31 




subroutines 43-47, 87 


inten-upts 46, 82. 126, 131, 170 




l/C SELECT' 123, 124, 169, 172 


intruction codes 180^192 




I/n STROBE' 124, 125, 172 


intruction cycle 140 


^^1^ 


i/DBEST ^^G 


INVERSE command 101 




r/DSAVE I5e 


inverse display lormat 19-20, 44. 




iC 6 


46, 52-3, 101 




IN* 103, 130 


Jn;< 190 




IM'n command 130 


I NY 190 




INC 190 


lOU 6,7, 143. 14S. 153, 155, 




indejt register 61. 106, 127, 140. 


164-7 




187 


IRQ vector 131, 140 




index register V 78, 187 


IRQ' 131, 170. 173 




index register X 78. 128, 187 






indirect addressing 64 


J 




INH' 144. 169, 173 


joystick 37 




input butter 56-58, 64, 106 


JMP intruction 79, 106. 190 




input devices 11-41 


JSR instruction 127, 190 




input fgatures 53-58 


Jump to Subroutjne 127 




INPUT Statement 56-7 






input, hand-conttol 35, 167 


K 




Input-Output Unrt see lOU 


keyboard 5, 11-17, 43-4, 83. 164 




inputs 


KEYBOflRO qammand 103 




analog 37, 39 


keyboard data 1 3, 28 




game 167 


keyboard encoder 6, 13. 149, 




switch 38. 167 


164 




instructions, assembiy 


Keyboard input Switch 130 




language TOB-11 
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*<ey Board strobe 13, 15, 28, 79, 

164 
keyboard input buffer 64 
KEVIN 43.47. 53-56. 129-30 

keypad 165 
KSU 54, 130 

KSWH 130 
K5WL 130 

L 

L (Monitor coniTTiafid) 117 
language card 68, 70. 121 
languages (see also names of 

languages) 

assetmbly 29, 108-9, 113 

ntgh-level 29, 43, 107 

machine 107-110 
la$l opened location 89-91, 94, 

96. 107, 109 
LDA 190 
LDX 190 
LDV 190 
LED 4, 166 

LEFT-ARRClw key 12, 55 
light-emiMing dJode 4, 166 
line voltage 137 
link addresses 47. 65. 130 
link registers 130 
link, input 54 
link, output 48 
links, standard I/O 47. 79, 129- 

30 
LIST command 108-10, 113 
loudspeaker 5, 165 
low-order bits 1 3. 24 
low-order byte 78 
low-resolution graphics 18 19, 22- 

3. 160 
low-resolution graphics blocks 22 
low-resolution graphics colors 23, 

160 
low&rcase characters 20, 44, 53 

LSR 191 

M 

M [Monitor command) 1 15 
machine language 107-10 
main circuit board 6. 37, 121 , 

139, 169, 174 
main memory 30, 73, 75. 77. 

78. 121 
memory 

ayxitiary 26, 30. 71-78 

bank-switched 68-71, 74, 79 

display 29-34. 154 

I/O 122,131 



main 30, 73,75. 77. 78, 127 

progammable see RAM 

read-only see ROM 
memory addressing 148-151 
memory dump 89-91 
memory locations 

I/O devices 11. 13, 27, 2B, 41 

peripheral card 122 
Memory Management Unit 6. 

143. 151 
memory maps 29, 31-4, 62. 63 
memory organization 61-33 
memory page 1 61, 73 
memory page 2 61 
memory page 3 65 
memory page zero see zero 

page 
memory pages 61 
memory range 91 
microprocessor, 6502 6. 140-142 

accumuiator 126 

circuitry 170 

contents of registers 97 

data bus 170 

interrupt requests 131 

instructions 107, 186 

memory addressing; 61, 64. 
121, 124, 14S-151 

Stack 64. 73 

timing 142, 149. 151 
Mini -ass em bier 57, 110-14 
Mini-assembier commands 1 1 7 
MIXED soft switch 28, 145 
mixed-mode display 19, 27 
MMU 6,143,151 
mnemonic 108, ill, 113. 114 
Monitor, Autostart 47 
Monitor, old 47, 110 
Monitor, System 43, 57, 63-6, B7- 

117. 129-31, 148 
Monitor commands 88-107, 109. 

115-7 
Monitor RDM 14S 
monitor, black-and-white 22, 24 
monitor, CO^Or 24, 25, tSO 
monitor, video 8, 17, 152 
MOVE command 94-7. 105 
muitiplexed addressing 150-1 

N 

N (Monitor command) 116 

nCDNTRDL-P 129 

National Television Standards 
Committee see NTSC 

next changeable location 89. 91, 
93. 94, 96 



P 



E 



c 
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1=1 


NMI 140 


peripheral devices 121-33, 169- 


^M 


NHt' 170, 173 


74 


^^k^tt 


NDP 191 


peripheral hardware 137 


^t^s 


NDRMflL command 101 


peripheral slots see expansion 


^M 


normal display format 19-20. 52- 


siots 


^^L^ 


3, 101 


P02 158, 161 


^^^^M 


NTSC 17, IB, 24, 152, 160. 163 


PHA 191 


^^~i 


NTSC color television 25 


phi 141, 142, 144, 146, 147, 


^M 


numeric pad 165 


151, 167, 174, 177 


ti 


nybble 22, 160 


phi 1 141. 142, 147, 151, 173, 
178 


^^T"^ 


o 


phi 2 141 


^M 


old Monitor 47. 110 


phone jacks 8 


^H^*"t 


opcode 110. 194 


PHP 191 


^^^^ 


OPEN-APPLE Itey 12.17,38,41. 


pipelining 6, 140 


^1 


ei 


PLA 191 


^^^__ 


operand 110. Ill 


PLP 191 


^E^A 


operating temperature 137 


plus sign (Inverse format) 56 


^^^^ 


operation codes llOr 194 


pointer, stack 64, 79, 140, 185, 


^1 


DRfl 191 


187 


^^^1^ 


ouHet, grounded 138 


paB;E 27 


^L^l 


output devices 11. 17-41 


potentiometers 39 


^k 


annunciator 37 


power 4, 5 


^^^ 


cassette 36 


power connector 139 


^^^5 


sIrobG 38 


power consumption 138 


^^^5! 


video display 17-34 


powef cord 6, 138 


^1 


output link 48 


power supply 5, 138-9, 


^^^^ 


output routine, standard 57 


power switch 6 


^E^^f 


overflow 78 


power-on reset 79 


M ^ 


overflow hit 78 


power-up byte 81-2 


^M 


P 


PR' 103. 130 


^^^^^ 


PR#0 46 


^LJ 


paddles 167 


PR'3 46 


^1 


page 1, memory 61, 73 


PR'n 129 


^^^ 


page 3. memory 65 


PliEfiD 40 


^^^H 


Page 1, high-resolution 24, 30. 


primary character set 19-21. 45. 


^■"^ 


65. 71 


53, 79. 158 


^1 


Page 1. text 26, 32, G5. 74 


PRINT statement 45. 130 


H^^ 


Page 2. high-resolution 24, 30, 


PRINTER command 102. 103 


g-f 


65 
Page 2, text 26, 27 


priority daisy chain 170 
processor status register 187 


^M 


page 2ero see zero page 


program counter 1 09, ill 


E^ 


ppiG£2 soft switch 28, 30, 72-5. 
143, 145, 161 


program, assembly language 43 
programmable memory see RAM 


^1 


pages, memory 61 


programmabEe storage 81, 63 


p^ 


PAL 143. 147. 151 
Pascal 43, 107 


Programmed Array Logic 
device 143. 147. 151 


^^1*^ 


PEEK 14,27,38.39 


PROU 121-3 


^M 


penod [.) 89 


pFompt characters 43, 56, 57 


^^^^ 


peripheral cards 8, 121-133, 138, 


• S7 


B|t_B 


169-74 


> 110 


^H ^ 


base addresses 127-9 


! 111 


H^^ 


I/O space 122 


protection circuit 139 


^^^^I| 


fiOM space 122, 133 


pseudo random number 54 


C 


subroutines 126 


pull-up resistors 167 
pu s hb utton switches 1 6 7 


I 
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o 

03 141. 144, 14e, 147, 151, 173 

R 



R 



99-100, 



121 



5^ 
see 



35 



I £1 



(Monitor command) 

116 
ft/W 144, 146, 176 
R/wea 175 
RAM 

and Monitor 47 

and peripheral cards 

and reset 79 

auxiliary 63, 71, 79 

bank-switched 68-70, 74, SO, 
110 

dynamic 143. 145, 149, 151 

memory access. 61, 149 

reserved memory 63 

second bank 70 
RAMRD 73-75. 143 
RflMNRT 73-75, 143 
random number 54 
random number, pseudo 
random-access memory 

RAM 
RAB 151 

RDKEY 43, 47, 54, 56 
reading data 28 
reading to secondary I/O 
READ command 99-100. 116 
read only memory see ROM 
read.'write signal 142 
recorder, cassette 3, 36, IGG 
registers 97.126,140.187 (see 

also accumulator) 

index 61, 127. 140, 185, 187 

link 130 

processor status 140, 187 

program counter 187 

size of 140 

stack pointer 64. 79, 140, 185, 
187 
relative addressing 108, 114. 126 
repeating keys 1 1 
RES' 173 

reserved memory pages 63 
RESET key 12, 13. 17, 79-61. 

83 
reset rouljne 17. 79-83 
reset vector 70, 79-83 
RESET^ 146 

reset, cold-start 80 
reset, forced cold-start ai 
reset, power-on 79 
reset, warmstart 80 
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resident program 81 
resistor, variable 16B 
resistors, pull up 167 
restricted-case mode 58 
Return (rom Subroutine 106. 127, 

129, 130, 192 
retype 58 
RF modulator 17, 152 

RIGHT'ARHQW key 12,58 
ROL 191 
roliover 11 
ROM 6 
and bank-switched memory 

68-70. 73. 79 
and memory addressing 6i, 

148 
and the Monitor 47 
character-generator 161 
Diagnostics 148 
expansion 123-5 
Monitor 148 

peripheral card 125, 132-3 
RDS 191 
routines 217-223 
routines, interrupt-handling 131 
Row-address Strobe 1 51 

RTI 192 

RTS 108, 127, 129. 130, 192 

s 

SBC 192 

scroSling 49, 50 

SEC 192 

second bank of RAM 70 

5ED 192 
5E J 1 92 
sell test 17 83. 131, 146 

SHIFT key 12. 13. 17, 164 
Short circuits 5, 139 
signal, read/write 142 
signals, dock 141-2 
Signals, liming 141-2,. 149, 159, 

161, 162. 169 
slot number 126-30 
slot, auxiliary see auKiiiary slot 
slot, expansion see expansion 

slots 

SL0TC3RDM 132, 133. 143 
SLOTCXROn 132, 143 
slots, ventilation 137 
soft switches 27. 92. 127, 143, 

145 (see also names of 

switches) 

and self test 83 

annunciator 37 

auxiliary memory 75 

bank select 69, 73-6, 79 
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I 

a 

a 



i 



definition 15 

dispEay 1 1 , 28 

game S/O 167 

keyboard 164 

speaker 35 
SOLID-APPLE key 12, 17, 38. 

41, at, S3 
sounds 5 
speaker 5. 11. 3&, 164. 166 

memory locations 41 

soft switches 35 
special function keys 1 7 
specifications, environmental 137 
BTA 192 

stack 64. 74. 78. 126 
stack overflow G4 
stack pointer 64, 79, 140. 185, 

187 
standard I/O links 47, 79, 129-31 
standard I/O subroutines 43-57, 

97 
standard input routine see KEY In 
standard output routine see COUT 
startup 80 
stop-list tealure 50 
stop-list function 50 
strobe 

column -address 151 

data 37, 167 

keyboard 13, 15, 28. 79. 164 

row-address 151 
strobe bit 14 

strobe output 35, 38, 40. 167 
STJ( 192 
STY 192 

subcarrier. color 25. 160 
subroutines 217-223 

auxiliary memory 76-79 

bultt-in 76-79 

I/O 43-58. 87 

peripheral -card 126 

standard input 54, 56 
sutjlraction 103 
suppiy currents 138 
suppiy voltage 138 
switch 38 
switch 1 38 
switch inputs 38. 167 
switches, pushbullon 167 
symbolic tabeis 1 10 
5¥MC' 146. 153, 174 
sync, horizontal 153 
Synertek Hardware Manual 141 
Synertck Programming 

Manual 113 



System Monitor see Monitor. 
System 

T 

tape recorder 36, 98, 166 

TAX 192 

Tftv 192 

television set 17, 22, 24. 25, 152 

temperature 137 

ten-key numeric pad 165 

TE)(T sofi switch 28. 146 

text 19-21.26-32 

text card see ao-column text card 

text card, extended ao-cofumn 71 

text characters see character 

sets 
text Page 1 26, 32, 65. 74 
text Page 2 26, 27 
text window 48-52. 79 
texU 40-column see 40-coiumn 

text 
text, SO'Column see 80-column 

text 
three-state buffers 170 
time constant 39 
timing signals 141-2, 149. 159, 

161. 162, 169 
toggle 35 

transistor-transistor logic 167 
TSx 192 
TTL 167 

TV set see television set 
TXA 193 
TXS 193 
TVA 193 

u 

UP-flRRUN 12 

uppercase characters 20, 44, 53 
uppercase- restrict mode 45 

USER 

V 

y (f\/lonttor command) 115 
validity-check byte 80.. B2 
variable resistor 168 
VBL 28, 145. 154 
vectors 47, 65, 71 

mterrupt B1-2. 131 

reset 70, 79-83 
ventitation stots 137 
VE,R1FY command 96, 97, 105 
vertical blanking 145, 154 
vertical counter 153, 155 
video counters 153. 157 
video display see display, video 
video modulator 17, IS 
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video rnonilor &, 17, 152 
video ouipLit signal 25. 163 
voUage. line 137, 138 
voltage, supply 13B 

w 

H (Monitor command) 98 100. 

116 
warm-slart reset 80 
window, text 48-52 
WNDW 146. 153, 176 
WRITE command 98-100, 116 
write-protect 69 
writing data 28 
writing to secondary I/O 35 

X 

X register 78. 187 
XF£(? 7B-9 

Y 

V register 7S, 126, 187 

z 

zero page 61. 64, 66-7, 73-8, 92, 

113. 126 
zero-page addressing 1 1 3 

Numbers 

MM 141, 147, 177 

3.50 MHz color signal 160-2 

3.S8M: (PAL Signal) 147 

3. sen (slot 7 signal) 174 

3 . SSM (auxtliary slot signal) 1 76 

3D0G 102 

40-column text IB. 2G. 44, 154 

6502 microprocessor 

see microprocessor. 6502 
6502 stack 73 
G502B microprocessor 6, 140 
?n 141, 147, 173. 178 
BO-column display 7, 30, 46, 72, 

159. 175 
BO-column firmware 45-47. 110, 

123-24 

cnuTi subroutine 52 
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